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ft convertToXml 

protected Element convertToXml (Message msg, Document doc) 
return an XML Message element from this message object 

Throws: 

MessagingException 

ft generateData 

protected void generateData ( ) 

Populate the cached data for outgoing messages. 

Throws: 

MessagingException 

ft- getDTD 

public DTD getDTD () 

return a DTD describing the XML that can be retreived using the XML Stream, Note: Not implemented yet; just returns null, 
ft getFolderlnfoElement 

protected Element getFolderlnfoElement (Folder folder, Document doc) 
Return an Element with information about the folder 

Jjft getHost 

Hjpublic String getHost () 

m — 

1 1| tgGet 

getMailbox 

republic String getMailbox () 

L *s Get 

yjft getPassword 

^public String getPassword ( ) 

ft getSaveables 

public Object [] getSaveables ( ) 

Return an array of all objects that should be persistent, primitive datatypes must be converted to their Object equivalent. These objects 
will come back in the same order when setSaveables is called. 

ft getUserAcct 

public String getUserAcct ( ) 
tgGet 

ft getXmlEIement 

protected Element getXmlEIement (String key, String value, Document doc) 
return an element with this name and value 

ft getXMLStream 

public InputStream getXMLStream { ) 

Return an input stream by which an XML document can be read. The XML Stream does NOT included DTD info. 
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Throws: 

NewEmaiiQEException 

• openMessageStore 

protected void openMessageStore ( ) 

Open the message store. Called from generateData() 

Throws: 

NoSuchProviderException 
MessagingException 

• requery 

protected void requery () 

Refresh the view of the external data source. By default, if the requery() call is made in an interval < the querylnterval from the 
lastCheckDate, then nothing will happen. 

• setHost 

public void setHost (String host) 
tgSet 

• setMailbox 

Jfpublic void setMailbox (String mailbox) 

3 tgSet 

jip setPassword 

J;public void setPassword (String password) 
S tgSet 

setSaveables 

J-ipublic void setSaveables (Object [] oa) 

f|I receive an array of objects that have been saved, the order will correspond to that specified when getSaveables was called. Users should 
l^i handle Null values in the array. 

setUserAcct 

? public void setUserAcct (String userAcct) 
tgSet 

B Class tcs.ainJnfosetver.NewEmailOueryEngine.XMLInputStream 

class XMLInputStream 

Extends: 

java. io. I nputStream 

This handles access to the XML data through an input stream. Each object to request the inputstream gets one of these, which handles 
sending the data to the client from the bytearray data. Can be used by children at their discretion (e.g., if spooling cached data) 

Attributes 

lastPos 

Operations 

read() 
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• lastPos 

int lastPos = -1 




# read 

public int read{) 



Throws: 

lOException 



H Class tcs.ainJnfoserver.NotifyChanseOnlyDestination 

public class NotifyChangeOnlyDestination 
Extends: 

tcs.ain.infoservsr.UserDeiiveryDestination 

Attributes 

^ debug 

W iastChecksum 

m 

^ Constructors 

m NotifyChangeOnlyDestination() 

^Operations 

fl cleanUpO 

yj getChecksum(java Jang. St ring) 

m notifyDestinations(tcs.ain.infoserver.DataWorker t tcs.ain.infoserverJDataSource) 
^ ' : ' processData(tcs.a i n . i nf oserver. Data Event) 



U» debug 

-^protected boolean debug 

5 # IastChecksum 

protected long IastChecksum 



S> NotifyChangeOnlyDestination 

public NotifyChangeOnlyDestination ( ) 




H cleanUp 

public voj d cleanup ( ) 

• getChecksum 

protected long getChecksum (java.lang. String) 



Page 113 of 332 



• notifyDestinations 

protected void notifyDestinations { tcs . ain . inf oserver . DataWorker , tcs . ain . inf oserver . IDataSource) 

• processData 

public void processData (tcs .ain. inf oserver .DataEvent) 

B Class tcs. ain. inf oserver. PageParserQEException 

public class PageParserQEException 
Extends: 

tcs.ain . inf oserver. I nf oServerException 



Constructors 

PageParserQEException(String) 



Constructor Detail 



IB 



51 PageParserQEException 

public PageParserQEException (String s) 



OH Class tcs.ain. infoserver. PazeParserOueryEngine 

^public class PageParserQuery Engine 
fjpctends: 

III tcs.ain.infoserver.QueryEngine 

JS~his query engine uses the TCS page parser to examine an htmi/xml document. The page parser provides access to the components of a 
1 5 page according to the underlying document structure. This engine allows the user to specify the portions of the page that are to be retrieved. 
jSBocument structure is according to common HTML tag elements if no targetElements are defined, then ail are returned 

"tAttributes 

H ba 

H! filename 

ffl startRef 

m targeted Elements 

(^Constructors 

P ¥ PageParserQueryEngine() 

Operations 

addTa rgetedEI ement(Stri ng, Stri ng) 

generateData() 

getDTDO 

getElementKeyWithName(String) 

getFilenameQ 

getSaveables() 

getStartRef() 

getTa rgetedEI em ent Key s() 
getTa rgetedEI em ents() 
getXMLAIias(String) 

getXMLStreamq 
includeData(String) 
removeTargetedElement(String) 
requery() 

setFilename(String) 
setSaveables(Object[]) 
setStartRef(String) 
setTargetedElements(Hashtable) 
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Attribute Detail 



• ba 

protected ByteArrayOutputStream ba 

This contains data that can be returned in the InputStream. 
transient 

i filename 

protected String filename 

The name of the file to process; name can be local filename or http address 

• startRef 

protected String startRef = new String (} 

Defines the some text to look for in the page to trigger when we started parsing it; if empty then we start parsing at the beginning 

i targetedEIements 

protected Hashtable targetedEIements = new HashtableO 

Contains the document structure value and an (optional) label to use in the XML structure we transmit format: page element : XML label 

2B: PageParserQueryEngine 

^Jjpublic PageParserQueryEngine () 

J J Construct with the specified page name to parse; can be local filename or http address. 



Pi addTargetedElement 

^public void addTargetedElement (String elementName, String xmlLabel) 
l^l Assign a targeted element; provide the actual element name along with an alias to be provided 

Wll generateData 

1 protected void generateData { ) / 

Populate the ba array with XML data from the page parser If no targetEiements are defined, we return all document data If no XML are 
explicitly defined for the elements, then the XML label is the document element label 

Throws: 

iOException 

if getDTD 

public DTD getDTD () 

return a DID describing the XML that can be retreived using the XML Stream. Note: Not implemented yet; just returns null. 
$ getEIementKeyWithName 

protected String getEIementKeyWithName {String name) 
Get the targetedEIements key object having this name null if not found 

i getFilename 

public String getFilename ( ) 

return a DTD describing the XML that can be retreived using the XML Stream. Note: Not Implemented yet; just returns null. 
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9 getSaveables 

public Object [] getSaveables { ) 

Return an array of al! objects that should be persistent, primitive datatypes must be converted to their Object equivalent. These objects 
will come back in the same order when setSaveabies is called. 

• getStartRef 

public String getStartRef { ) 

Return the assigned text that triggers when the pageParser will start parsing the page. 

SI getTargetedElementKeys 

public Enumeration getTargetedElementKeys ( ) 

Return the Enumeration of targeted Elements that have been defined for inclusion in the XML data 

• getTargetedElements 

public Hashtable getTargetedElements ( ) 

• getXMLAIias 

public String getXMLAIias (String element) 

Return the XML label defined for the specified targeted element Null if none defined 

f# getXMLStream 

'^public InputStream getXMLStream ( ) 

^ Return an input stream by which an XML document can be read. The XML Stream does NOT included DTD info. 
[II Throws: 

'I* PageParserQEException 
5|l includeData 

..protected boolean includeData (String keyStr) 

CI Return whether we should include data in the XML document for the documentElement of the targeted page If no targetedElements have 
f|| been defined, then always true. Otherwise, only if a targeted Element has been previously defined for the document element 

removeTargetedEIement 

^public void removeTargetedEIement {String elementName) 

H remove the element identifier from the list of elements to target in the XML document 

• requery 

protected void requery () 

Refresh the view of the external data source. By default, if the requery() call is made in an interval < the querylnterval from the 
lastCheckDate, then nothing will happen. 

Throws: 

lOException 

• setFilename 

public void setFilename (String filename) 

return a DTD describing the XML that can be retreived using the XML Stream. Note: Not Implemented yet; just returns null. 

9: setSaveabies 

public void setSaveabies {Obj ect [ ] oa) 

receive an array of objects that have been saved, the order will correspond to that specified when getSaveables was called. Users should 
handle Null values in the array. 
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m setStartRef 

public void setStartRef {String ref} 

Assign the text that triggers when the pageParser will start parsing the page. If not defined, the page parser will start from the beginning. 
Otherwise it will only start parsing when it finds the text in the displayed text or in the param string of a tag 

• setTargetedEIements 

public void setTargetedEIements (Hashtable targetedElements) 



Class tcs.ainJnfoserver.PageParserOueryEngine.XMLInputStream 



class XMLInputStream 

Extends: 

java.jo.lnputStream 

This handles access to the XML data through an input stream. Each object to request the inputstream gets one of these, which handles 
sending the data to the client from the bytearray data. Can be used by children at their discretion (e.g., if spooling cached data) 

Attributes 

lastPos 

Operations 

read() 

g# lastPos 

ylint lastPos = -1 



K : i!-: :: ". E : ■ 



M read 



ic int read{] 



JJpubl 

! 11 Throws: 

Ijl lOException 

B Class tcs.ain.infoserver.pqa.LCDemoPublicDS 

public class LCDemoPublicDS 
Tests the I MAP Query Engine; query every one minute 

Constructors 

LCDemoPublicDS() 

Operations 

main(String[]) 



uctor Detail 



• LCDemoPublicDS 

public LCDemoPublicDS ( ) 



Throws: 

Exception 
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• main 

public static void main (String [] args) 

B Class tcs.ain.infoserver.pqa.PQAEBook 

public class PQAEBook 

Extends: 

tcs.ain.infoserver.pqa.PQAPage 

Launch a DataWorker for a given Agent, and return results 

Attributes 

AGENTJD 

ATTRVAL 

HtmlPage 

LCRESU LTS 1_PATH 
TAG 

workerld 
WORKER.! D 

Constructors 

n PQAEBook(HttpServletRequest, HttpServletResponse, String) 

^Operations 

^1 getBodyO 

fn getForm(String) 

if\ GetPageldQ 

%t getTagTable(String) 



im AGENTJD 

^protected static final String AGENT_ID = "rsmith" 
III Agent ID 

pf» ATTRVAL 

^gprotected static final String ATTRVAL = "SF_ATTRSTR ft 
Attribute Value parameter name constant 

• HtmlPage 

protected static StringBuffer HtmlPage - null 
Stores Html Page associated with a form producing class 

m LCRESU LTS 1_P ATH 

public static final String LCRESULTS1_PATH = QNetPQARe source .getString ( "LCResultsl" ) 
Results Page Path 

• TAG 

protected static final String TAG = "SF_TAG" 
Tag parameter name constant 

• workerld 

protected String workerld = " " 

Stores Htm! Page associated with a form producing class 
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• WORKERJD 

protected static final String WORKER_ID = "LC Operation Manual" 
WorkerlD 



» PQAEBook 

public PQAEBook (HttpServl et Request request, HttpServletResponse response, String userName) 
Constructor calls superQ and sets the title for this page 



Operation Detail 







II getBody 

public String getBody 0 

get Login Body. Since the initial login form is stored on the pqa, this should only be called to retrieve an error login 

• getForm 

protected String getForm (String results) 

Create an html form for selecting or removing existing Data Workers. This is the initial form for the Query Net Wizard 

fj 

3* GetPageld 

%public static int GetPageld {) 

ijp getTagTable 

#protected Hashtable getTagTable {String results) 

Jj, Create a table of tags and their values to be used in replacing tags found in static html pages. Used to add dynamic content to these 
^ pages. 



S|H Class tcs.ain.infoserver.pqa.PQALauncher 

i public class PQALauncher 
JjExtends: 

^ tcs.ain.infoserver.pqa.PQAPage 

Launch a DataWorker for a given Agent, and return results 

Attributes 

HtmlPage 
workerid 

Constructors 

PQALauncher(HttpServletRequest, HttpServletResponse, String) 

Operations 

getBodyO 
getForm(String) 
GetPageld() 
getTagTable(Stri ng) 

HtmlPage 

protected static StringBuffer HtmlPage = null 
Stores Html Page associated with a form producing class 
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• workerld 

protected String workerld = 

Stores Html Page associated with a form producing class 

■9. PQALauncher 

public PQALauncher (HttpServlet Request request, HttpServletResponse response, String userName) 
Constructor calls super() and sets the title for this page 

• getBody 

public String getBody () 

get Login Body. Since the initial login form is stored on the pqa, this should only be called to retrieve an error login 

• getForm 

protected String getForm (String results) 

Create an html form for selecting or removing existing Data Workers. This is the initial form for the Query Net Wizard 

ill GetPageld 

"^public static int GetPageld () 
111* getTagTable 

^protected Hashtable getTagTable {String results) 

fji Create a table of tags and their values to be used in replacing tags found in static html pages. Used to add dynamic content to these 
w pages. 



IMS Class tcs.ain.infoserver.pqa.PQALogin 

^public class PQALogin 

Jjfcxtends: 

tcs.ain.infoserver.pqa.PQAPage 

USER LOGIN PAGE. This prompts user for username/pw and tries and to find (or create) a UserAgent object for them. The UserAgent object 
is inserted into the user's Session under the name 'userAgent 1 , for retention between screens This will eventually validate against and 
reference the SMS Internet Suite Userlnfo database. Note: New agents are created for authenticated users, and their WebProv values will be 
assigned to the agent for name, email, min We will need to keep the agent info up-to-date somehow. 



Attributes 

HtmiPage 
InvalidLoginMsg 

Constructors 

PQALogin(HttpServ!etRequest, HttpServletResponse) 

Operations 

getBody() 
getForm() 
GetPageldQ 
getTagTable() 

isValidLogin(ResultSet, String) 

ProcessLogin(HttpServletRequest) 

QueryUserlnfoDB(String) 
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• Htm I Page 

protected static StringBuffer HtmlPage = null 
Stores Html Page associated with a form producing class 

• InvalidLoginMsg 

protected static final String InvalidLoginMsg = QNetPQAResource .getStringC InvalidLoginMsg" } 
Stores Html Page associated with a form producing class 



m PQALogin 

public PQALogin (HttpServletReque st request, HttpServletResponse response) 
Constructor calls super() and sets the title for this page 



• getBody 

E|public String getBody ( ) 

get Login Body. Since the initial login form is stored on the pqa, this should only be called to retrieve an error login 

^| 

UMi getForm 

^protected String getForm () 

f 5 Create an html form for selecting or removing existing Data Workers. This is the initial form for the Query Net Wizard 
tt^l GetPageld 

^.public static int GetPageld {) 

getTagTable 

^protected Hashtable getTagTable ( ) 

EJ Create a table of tags and their values to be used in replacing tags found in static html pages. Used to add dynamic content to these 
1^ pages. 

• IsValidLogin 

protected static boolean IsValidLogin (Re suits et r, String password) 
Autherticate the user. 

• ProcessLogin 

public static String ProcessLogin (HttpServlet Request req) 

Validate a login, return username if valid log in, null if invalid. REMEMBER: users can log in with Alias or PIN so be sure 

• QueryllserlnfoDB 

protected static ResultSet QueryUserlnf oDB {String username) 
Query the UserProvisioning database for the login name 



Class tcs.ain.infoserver.pqa.POAMenu 



publ i c class PQAMenu 

Extends: 

tcs.ain.infoserver.pqa.PQAPage 
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Return a Menu listing of ail DataWorkers belonging to a given UserAgent 
Attributes 

HtmlPage 
NoWorkersPage 

Constructors 

PQAMenu(HttpServletRequest, HttpServietResponse, String) 

Operations 

getBody() 

getForm(Vector) 

GetPageldO 

getSelectBoxOptions(Vector) 
getTagTa bl e(V ector) 

• HtmlPage 

protected static StringBuffer HtmlPage = null 
Stores Html Page associated with a form producing class 

• NoWorkersPage 

■protected static StringBuffer NoWorkersPage = null 
& i Stores Html Page associated with a form producing class 




■p PQAMenu 

1|>ublic PQAMenu (HttpServl etReque st request, HttpServietResponse response, String userName) 
Constructor calls superQ 




getBody 

public String getBody () 

get Menu Body. List al! DataWorkers associated with a given agent 

• getForm 

protected String getForm (Vector workerList) 

Create an html form for selecting or removing existing Data Workers. This is the initial form for the Query Net Wizard 

m GetPageld 

public static int GetPageldO 

• getSelectBoxOptions 

protected String getSelectBoxOptions (Vector workerList) 
Create a select box for the given parameter and select a specified value. * 

• getTagTable 

protected Hashtable getTagTable (Vector workerList) 

Create a table of tags and their values to be used in replacing tags found in static html pages. Used to add dynamic content to these 
pages. 
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H Class tcs.ain.infoserver.pqa. PQAPage 

public abstract class PQAPage 

Extends: 

tcs.web.WebPage 

Implements: 

tcs.ain.infoserver.pqa.PQAConst 
Launch a OataWorker for a given Agent, and return results 

Attributes 

userName 

Constructors 

PQAPage(HttpServletRequest, HttpServletResponse) 
PQAPage(HttpServletRequest, HttpServletResponse, String) 

Operations 

getHtmlPage(String) 
replaceTags(String, Hashtable) 



pjl userName 

^protected String userName 

l» PQAPage 

Jfijbublic PQAPage (HttpServletRequest request, HttpServletResponse response) 
Constructor calls super() and sets the title for this page 

|^ PQAPage 

^public PQAPage (HttpServletRequest request, HttpServletResponse response, String userName) 
51 Constructor calls superQ and sets the title for this page 



• getHtmlPage 

public StringBuffer getHtmlPage (String path) 

Read in specified Html Page and store to static Html Page StringBuffer 

Throws: 

Exception 

if replaceTags 

public String replaceTags (String content, Hashtable ht) 
Read in specified Html Page and store content to StringBuffer 



a Class fcs. a in. infoserver.pqa. POAPagePrinter 

public class PQAPagePrinter 

Extends: 

tcs.web.WebPagePrinter 

Base class for web page printing operations. Provides methods to print the header, banner, etc. Subclasses can provide distinct color / font 
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/ banner schemes for individual projects or pages 

Constructors 

PQAPagePrinter(WebPage) 

Operations 

print() 

• PQAPagePrinter 

public PQAPagePrinter (WebPage page) 

Construct the page printer object. This assings the owner and gets the output stream 



• print 

public void print { ) 

public print method; what client calls to start the printing process. This calls the basic components of the page (header, banner, body, 
footer) 

5|B Class tcs.ain.infoserver.pqa.PQAServletMain 

w. E 

public class PQAServletMain 



if 
1 



[Extends: 

tcs.web.WebMain 
Implements: 

tcs.ain.infoserver.pqa.PQAConst 



"This is the Main page for the QueryNet PQA Serviet This loads pages according to the received Section variable 

si 

f! 

^Attributes 

.^s cursorCount 
*Jf cursorLimit 
gll. infoServerAccess 
f?fc jdbcConn 
MainApp 

Constructors 

PQAServletMain() 

Operations 

cursorAvailable() 
getDbConnection() 

getRMIConnection() 
getWebPagePrinter(WebPage) 

loadSection(HttpServletRequest, HttpServletResponse) 

makeDbConnection() 

makeRMIConnection() 

releaseCursor() 

showDBError(HttpServletResponse) 
showRMIError(HttpServletResponse) 
validateDbConnectionO 
validateRMIConnectionQ 



• cursorCount 

protected static int cursorCount = 0 
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The database cursors currently open by repository. 

• cursorLimit 

protected static final int cursorLimit = QNetPQARe source .getlnt ( "DbCursorLimit " ] 
The database cursor limit for the Repository database connection. 

• infoServerAccess 

protected static IReraoteRepository infoServerAccess = null 

Remote InfoServer Access Repository for loading / saving User Agents and Sources. Accessed via RM! 

• jdbcConn 

protected static Connection jdbcConn 

JDBC Connection for querying provisioning information from database 

• MainApp 

public static String MainApp = QNetPQAResource .getString { "MainAppPath" ) 



m PQAServletMain 

^jbubl ic PQAServletMain { ) 



|H cursorAvailable 

M|>rotected static boolean cursorAvailable ( ) 
Check to see if cursor limit has been reached 

Qi getDbConnection 

public static Connection getDbConnection( } 

Return a reference to jdbcConn if the CursorLimit has not been exceeded and a valid connection can be established, otherwise return nuii. 
This protects from exceeding the a given Database Implementation's cursor limit setting. It is the calling procedures responsibility to call 
fc! release cursor when finished using the jdbcConn reference. Throws exception if unable to establish a valid database connection 

Throws: 

SQLException 

• getRMIConnection 

public static IRemoteRepository getRMIConnection ( ) 

Connect the remote object to the server if necessary and return RM! Connection 

Throws: 

Exception 

Si getWebPagePrinter 

public WebPagePrinter getWebPagePrinter {WebPage wp) 

Connect the remote object to the server if necessary and return RMi Connection 

Throws: 

Exception 

9 loadSection 

protected void loadSection (HttpServletRequest request, HttpServletResponse response) 
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• makeDbConnection 

protected static void makeDbConnection ( ) 

Make sure jdbcConn is valid. If not, report the error to out and return false 

Throws: 

SQLException 

• makeRMIConnection 

protected static void makeRMIConnection ( ) 
Connect the remote object to the server if necessary 

Throws: 

Exception 

• releaseCursor 

public static void releaseCursor { ) 

Decrement cursorCount so that another process may reference jdbcConn 

• showDBError 

^protected static void showDBError (HttpS ervlet Response response) 
lii* Display a spiffy RMI error message 

% showRMIError 

i' protected static void showRMIError (HttpS ervlet Response response) 
■I* Display a spiffy RMI error message 

9fl validateDbConnection 

protected static void validateDbConnection ( ) 

| J Make sure con is valid. If not, report the error to out and throw the exception 

jpjg Throws: 

JJ* SQLException 

?# validateRMIConnection 

'protected static void validateRMIConnection ( ) 

make connection if necessary; test the connection; if failed, try to to remake the connection return true if good connection 

H Class tcs.ainJnfoserver.pqa.ONetPOAResource 

public class QNetPQARe source 

This class is a singleton for a property resource bundle to be used by the QueryNet PQA Servlet. The resource bundle contains values that 
could potentially be displayed to users. It also provides a direct, static method for safely getting String values without worrying about 
MIssingResourceExceptions ras; 2/29/99; modified by S. Levine on 5/01/00 

Attributes 

resourceBundle 

Operations 

getBundle() 
getlnt(String) 
getString(String) 
initResourceBundleQ 
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© resourceBundle 

private static ResourceBundle resourceBundle = null 
The resource bundle we keep for use by the package. 




H getBundle 

public static ResourceBundle getBundle () 

Return the single, static instance of the resource bundle for the SMPP Module 



Wt getlnt 

public static int getlnt (String key) 

Pass through to the resourceBundle, except that we internally catch the MissingResourceException and report the error but return a "?". 
Return Int value. 

• getString 

public static String getString (String key) 

Pass through to the resourceBundle, except that we internally catch the MissingResourceException and report the error but return a 'T 

*fjfc initResourceBundie 

private static void initResourceBundie ( ) 
ill Create the resource bundle 

fefi Class tcs.ain.infoserver. ONConst 

b public class QNConst 

fljA ttributes 

III ACTION 

m ADDBTNTAG 

2? AD DCUSTBTNTAG 

I** ADDCUSTDS 

M ADDEDiTPATH 

ADDPUBBTNTAG 

ADDPUBDS 

AGENTDESC 

AGENTDESCTAG 

AGENTNAME 

AGENTNAMETAG 

A LT_AD DRESSING 

AVAILABLEL 1ST 

AVA1LDESTLIST 

BTN.ADDCUSTOM 

BTN_ADDDEST 

BTN_ADDPUBL!C 

BTN_CANCEL 

BTN_EDITAGENT 

BTN_FINISH 

BTN_HELP 

BTNJ.OGIN 

BTN„NEXT 

BTN_PREV 

BTNJREMOVE 

BTN_RE MOVED EST 

BTN_SELECT 

BTN_SUBM!T 

CANCELBTNTAG 

CBX_PREFIX 
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CFGCONTENTTAG 

CFGCUSTPATH 

CREATENEWDS 

CURRENTLIST 

CUSTAGENT PATH 

CUSTDSPATH 

CUSTOMIZE 

DATASOURCES 

DATAWORKER 

DEBUGMODE 

DEFAULT.FORMAT 

DESTINATION 

DESTINATIONS 

DESTOPTSTAG 

DESTPATH 

DOM 

DOMOPTSTAG 
DOW 

DOWOPTSTAG 

DSNAMETAG 

DSOPTSTAG 

EDITAGENTBTNTAG 

EDT_PREFIX 

EDT_WORKERNAME 

ERRORMSGTAG 

FINISHBTNTAG 

FORMNAME 
^. HELPBTNTAG 
CI HOUR 
yj HOUROPTSTAG 
Z\ HTTP 
J* LOGINBTNTAG 

LOG IN PATH 
III MAILBOX 
>. MENU PATH 
?! MINOPTSTAG 
^ MINUTES 
S| MIN_LENGTH 
7" NEXTBTNTAG 
;U NOTIFIER 
U- NOTIFYTAG 
flj ON 

m ONCHANGEBOX 

PIN_LENGTH 
W PIN_PREF1X 
O PREVBTNTAG 

PREVIEWBTNTAG 
r " PUBDSPATH 

REMOVEBTNTAG 

REMOVEDESTBTNTAG 

REQUIRED 

SCRIPTTAG 

SELECTBTNTAG 

SELECTDESTSTAG 

SERVICESTAG 

SOURCENAME 

START 

STATUSPATH 

STEP 

STYLE 

STYLETAG 

SUBMITBTNTAG 

TESTID 

TESTMODE 

USERAGENT 

USERNAMETAG 

ViEWPATH 

WORKERDESCTAG 

WORKERNAMETAG 

WORKERSLIST 

WORKOPTSTAG 
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• ACTION 

public static final String ACTION = "action" 



• ADDBTNTAG 

public static final String ADDBTNTAG = "<!-- ADDBTN -->" 
9t ADDCUSTBTNTAG 

public static final String ADDCUSTBTNTAG = "<!-- ADDCUSTBTN -->" 

• ADDCUSTDS 

public static final String ADDCUSTDS = "CDS" 

• ADDEDITPATH 

public static final String ADDEDITPATH = QNServletResource .getstring ( "AddEditPath" ) 

m ADDPUBBTNTAG 

public static final String ADDPUBBTNTAG = "<!-- ADDPUBBTN -->" 
Hi ADDPUBDS 

public static final String ADDPUBDS = "PDS" 

|p AGENTDESC 

Upublic static final String AGENTDESC = "agentdesc" 
\0 AGENTDESCTAG 

Kpublic static final String AGENTDESCTAG = "<!-- AGENTDESCINFO -->" 

0* AGENTNAWIE 

LHmblic static final String AGENTNAME = "agentname" 
t*m AGENTNAMETAG 

public static final String AGENTNAMETAG = "<!-- AGENTNAMEINFO -->" 

• ALT_ADDRESSING 

public static final String ALT_ADDRES S I NG = QNServletResource.getStringC'supportAltAddressing") 

• AVAILABLELIST 

public static final String AVAILABLELIST = "availableDSList " 

• AVAILDESTLIST 

public static final String AVAILDESTLIST = "availDestList" 

• BTN_ADDCUSTOM 

public static final String BTN_ADDCUSTOM = QNServletResource .getstring ( "AddCustom" ) 
m BTN_ADDDEST 

public static final String BTN_ADDDEST = QNServletResource.getStringC'AddBtn") + " ->" 

• BTN_ADDPUBLIC 

public static final String BTN_ADDPUBLI C = QNServletResource . getstring ( "AddPublic " ) 
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• BTN_CANCEL 

public static final String BTN_CAKCEL = QNServletRe source .getString ( "CancelBtn" ) 

• BTN_EDITAGENT 

public static final String BTN_ED I TAGENT = QNServletResource. getStringC'EditAgentBtn") 
m BTN_FINISH 

public static final String BTN_FINISH = QNServletRe source .getString ( "FinishBtn" ) 
9t BTN_HELP 

public static final String BTN_HELP = QNServletResource .getString ( "HelpBtn" ) 

• BTNJ.OGIN 

public static final String BTN_LOGIN = QNServletResource. getString ("LoginBtn") 
m BTN_NEXT 

public static final String BTN_NEXT = QNServletResource. getString ("NextBtn") 

• BTN_PREV 

public static final String BTN_PREV = QNServletResource .getString ( "PrevBtn" ) 
tfb BTN_REMOVE 

^public static final String BTN_REMOVE = QNServletResource. getString ( "RemoveBtn" ) 

vr-V: 

U|| BTN_REMOVEDEST 

BSS- 

public static final String BTN_REMOVEDEST = "<- " + QNServletResource . getString ( "RemoveBtn" ) 
% BTN_SELECT 

^ public static final String BTN_S ELECT = QNServletResource . getString ( "SelectBtn" } 
jjfl BTN_SUBMIT 

^public static final String BTN^SUBMIT = QNServletResource .getString ( "SubmitBtn" } 
tJ* CANCELBTNTAG 

public static final String CANCELBTNTAG = "<!-- CANCELBTN -->" 

• CBX_PREFIX 

public static final String CBX_PREFIX = "CBX_" 

• CFGCONTENTTAG 

public static final String CFGCONTENTTAG = ■'<!-- CFGCONTENTINFO -->" 

m CFGCUSTPATH 

public static final String CFGCUSTPATH = QNServletResource . getString ( "CfgCustPath 11 ) 

• CREATENEWDS 

public static final String CREATENEWDS = " NDS " 

• CURRENTLIST 

public static final String CURRENTLIST = "currentDestList" 

• CUSTAGENTPATH 
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public static final String CUSTAGENTPATH = QNServletResource .getString ( "CustAgentPath" ) 

• CUSTDSPATH 

public static final String CUSTDSPATH = QNServletResource .getString { "CustDSPath" ) 

• CUSTOMIZE 

public static final String CUSTOMIZE = "CA" 

« DATASOURCES 

public static final String DATASOURCES = "dataSources" 

• DATAWORKER 

public static final String DATAWORKER = "dataWorker" 

• DEBUGMODE 

public static final boolean DEBUGMODE = 

Boolean . valueOf (QNServletResource . getString ( "DebugMode" ) ) . booleanValue ( ) 

• DEFAL) LT_FORM AT 

public static final String DEFAULT_FORMAT = "default" 

DESTINATION 

^public static final String DESTINATION - "DF" 

tVm DESTINATIONS 

J-public static final String DESTINATIONS = "destinations" 

Em DESTOPTSTAG 

s: public static final String DESTOPTSTAG = "<!— DESTOPTIONS -->" 

nm DESTPATH 

ftfpublic static final String DESTPATH = QNServletResource .getString { "DestPath" } 
DOM 

^public static final String DOM = "dom" 
m DOMOPTSTAG 

public static final String DOMOPTSTAG = "<!-- DOMOPTIONS -->" 

• DOW 

public static final String DOW = "dow" 

• DOWOPTSTAG 

public static final String DOWOPTSTAG = ■•<!-- DOWOPTIONS -->" 
m DSN AM ET AG 

public static final String DSNAMETAG = "<!-- DSNAMEINFO -->" 

m DSOPTSTAG 

public static final String DSOPTSTAG = "<!-- DSOPTIONS -->" 

• EDITAGENTBTNTAG 

public static final String EDITAGENTBTNTAG = "<!-- ED I T AGENTBTN -->" 
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m EDT_PREFIX 

public static final String EDT_PREFIX = "EDT_" 

• EDT_WORKERNAME 

public static final String EDT_WORKERNAME = "workerNameEdt" 

• ERRORMSGTAG 

public static final String ERRORMSGTAG = "<!-- ERRORMSG -->" 

• FINISHBTNTAG 

public static final String FINISHBTNTAG = "<!-- FINISHBTN -->" 

• FORMNAME 

public static final String FORMNAME = "step" 

• HELPBTNTAG 

public static final String HELPBTNTAG = "<!-- HELPBTN -->" 

m HOUR 

public static final String HOUR = "hour" 

|l» HOUROPTSTAG 

Nipublic static final String HOUROPTSTAG = "<!-- HOUROPTIONS -->" 
III* HTTP 

#=public static final String HTTP = "http://" 

i \ 

BB* LOGINBTNTAG 

" public static final String LOGINBTNTAG = "<!-- LOGINBTN -->" 

rtln LOG IN PATH 

PI! 

LZfpublic static final String LOGINPATH = QNServletResource .getString ( "LoginPath" ) 

pm MAILBOX 

public static final String MAILBOX = "INBOX" 

9 MENUPATH 

public static final String MENUPATH = QNServletResource .getString ( "MenuPath" ) 

m MINOPTSTAG 

public static final String MINOPTSTAG = "<!-- MINUTEOPTIONS -->" 
m MINUTES 

public static final String MINUTES = "minutes" 

m MINJ.ENGTH 

public static final String MIN_LENGTH = QNServletResource .getString ( "minLength" ) 
m NEXTBTNTAG 

public static final String NEXTBTNTAG = "<!-- NEXTBTN -->" 

• NOTIFIER 
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public static final 

• NOTIFYTAG 

public static final 

9 ON 

public static final 

• ONCHANGEBOX 

public static final 

• PINJ.ENGTH 

public static final 

m PIN_PREFIX 

public static final 

ft PREVBTNTAG 

public static final 

~M PREVIEWBTNTAG 

yf|public static final 

\i 

gj* PUBDSPATH 

yipublic static final 

Ujft REMOVEBTNTAG 

public static final 

CI* REMOVEDESTBTNTAG 

[^public static final String REMOVEDESTBTNTAG = "<!-- REMOVEDESTBTN -->" 

Qm REQUIRED 

! ?? *public static final String REQUIRED = "Req" 
ft SCRIPTTAG 

public static final String SCRIPTTAG = »<!-- SCRIPT -->" 
ft SELECTBTNTAG 

public static final String SELECTBTNTAG = "<!-- SELECTBTN -->» 

ft SELECTDESTSTAG 

public static final String SELECTDESTSTAG = «<!-- SELECTEDDESTS -->" 

ft SERVICESTAG 

public static final String SERVICESTAG = "<!-- SERVICESINFO -->" 

• SOURCENAME 

public static final String SOURCENAME = " sourceName " 

• START 

public static final String START = "START " 



String NOTIFIER = "Notifier" 



String NOTIFYTAG = "<!-- NOT I FY INFO -->" 



String ON = "on" 



String ONCHANGEBOX = "OnChangeBox" 



String PIN_LENGTH = QNServlet Re source . getString ( "PinLength" ) 



String PIN_PREFIX = QNServletResource .getString ( "PinPrefix" ) 



String PREVBTNTAG = "<!-- PREVBTN -->" 



String PREVIEWBTNTAG = «<!-- PREVIEWBTN -->" 



String PUBDSPATH = QNServletResource .getString ( "PubDS Path" ) 



String REMOVEBTNTAG = "<!-- REMOVEBTN -->" 



Page 133 of 332 



• STATUSPATH 

public static final String STATUSPATH = QNServlet Re source . getString ( "StatusPath" ) 

m STEP 

public static final String STEP = "step" 
m STYLE 

public static final String STYLE = "Style" 

• STYLETAG 

public static final String STYLETAG = »<!-- STYLE INFO -->" 

m SUBMITBTNTAG 

public static final String SUBMITBTNTAG = "<!-- SUBMITBTN -->" 
m TESTID 

public static final String TESTID = "username" 

• TESTMODE 

public static final boolean TESTMODE = 
^Boolean. valueOf (QNServletResource .getString ( "TestMode" ) ) .booleanValue ( ) 

if* 

Opt USERAGENT 

"a 

republic static final String USERAGENT = "userAgent" 

J* USERNAMETAG 

lljpublic Static final String USERNAMETAG = "<!-- USERNAME INFO -->" 

, » VIEWPATH 

Clpublic static final String VIEWPATH = QNServletResource .getString { "ViewPath" ) 
Hi* WORKERDESCTAG 

Clpublic static final String WORKERDESCTAG - "<!-- WORKERDESCINFO -->" 
i»« WORKERNAMETAG 

public Static final String WORKERNAMETAG - "<!-- WORKERNAMEINFO -->" 

• WORKERSLIST 

public static final String WORKERSLIST = " worker sLi st " 

• WORKOPTSTAG 

public static final String WORKOPTSTAG = »<!-- WORKEROPTIONS -->" 



S3 Class tcs.ain.infoserver.QNServerResource 

public class QNServerRe source 

This class is a singleton for a property resource bundle to be used by the Query Net Wizard. The resource bundle contains values that could 
potentially displayed to users. It also provides a direct, static method for safely getting String values without worrying about 
MissingResourceExceptions ras; 2/29/99; modified by S. Levine on 9/9/99 



Attributes 

resourceBundle 
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Operations 

getBundleO 
getlnt(String) 
getString(String) 
initResourceBundleQ 



A. ttrii)iit 



• resourceBundie 

private static ResourceBundie resourceBundie = null 
The resource bundle we keep for use by the package. 



if getBundle 

public static ResourceBundie getBundleO 

Return the single, static instance of the resource bundle for the SMPP Module 

tgetlnt 

public static int getlnt (String key) 

1) Pass through to the resourceBundie, except that we internally catch the MissingResourceException and report the error but return a T. 
f% Return Int value. 

getString 

flpublic static String getString (String key) 

11 Pass through to the resourceBundie, except that we internally catch the MissingResourceException and report the error but return a 
si Return String value. 

initResourceBundle 

^private static void initResourceBundle ( ) 
II Create the resource bundle 



;IH Class tcs.ain.infoserver. QNWebPagePrinter 

•^public class QNWebPagePrinter 

Extends: 

tcs.web.WebPagePrinter 

Attributes 

printBanner 

Constructors 

QNWebPagePrinter(tcs.web.WebPage) 

Operations 

print() 

printPageDescription() 
SI printBanner 

protected boolean printBanner 
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m QNWebPagePrinter 

publ ic QNWebPagePrinter ( tcs . web . WebPage ) 




tail 




• print 



public void print ( ) 

• printPageDescription 

protected void printPageDescription () 

B Class tcs.ain.infoserver. Query Engine 

public abstract class QueryEngine 
Extends: 

tcs.ain.infoserver. I nfoServerEiement 
Implements: 

^ tcs.ain.infoserverJDataSource 

Queries external sources for information which can be made available to DataDestination object. As required, this provid 



"ii address 

DefaultMaxQuerySize 
yf DefaultQueryRefreshTime 
fi% formatter 

lastCheckDate 
^ maxQuerySize 
Q minAiiowedQuerylntervai 
ff| xslDocs 

^Operations 

¥f addXSLDocument(String, org.w3c.dom. Document) 
13 getAddress() 

getDefaultMaxQuerySize() 

getFormatter() 

getLastCheckDate() 

getM inAII owedQ uery i nterva ! () 

getXSLDocCountO 

getXslDocs() 

getXSLDocument(String) 

getXSLName(int) 

removeXSLDocument(Stri ng) 

setAddress(String) 

setDefaultMaxQuerySize(long) 

setFormatter(Data Formatter) 

setLastCheckDate(long) 

setMinAllowedQuerylnterval(long) 

setXslDocs(Hashtabie) 



9k address 

protected String address 

The address of the data to be queried. Format is dependent on type. 

• DefaultMaxQuerySize 
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protected static long Def aultMaxQuerySize = 102400 
Default sizein bytes for how much data is to be queried. 

• DefaultQueryRefreshTime 

protected static long DefaultQueryRefreshTime =1000*60*30 
The default interval to wait before refreshing any data. 

•! formatter 

protected DataFormatter formatter = new DataFormatter ( ) 

The default dataformatter to be used. This will be used in a launch on demand (i.e. "M0") situation where want to retrieve data directly 
from the Datasource. 

ft lastCheckDate 

protected Date lastCheckDate = new Date{0) 

The last time the external source data was queried; how recent this information is. 

• maxQuerySize 

protected long maxQuerySize 

How much data we will retrieve (in bytes) Default is Max_Query_Size 

til minAllowedQuerylnterval 

^protected long minAllowedQuerylnterval = DefaultQueryRefreshTime 

¥$k xslDocs 

E :T s 

"^protected Hashtable xslDocs = new HashtableO 



y| Hashtable of XSL Documents, keyed on the descriptive name 




a M : addXSLDocument 

Hj>ublic void addXSLDocument (String name, org. w3c.dom. Document doc) 
51 Add this name/document to the list of offered XSL docs 

r get Ad dress 

public String getAddressO 



tgGet 

$ getDefaultWIaxQuerySize 

public long getDef aultMaxQuerySize { ) 
tgGet 

• getFormatter 

public DataFormatter getFormatter ( ) 
tgGet 

• getLastCheckDate 

public Date getLastCheckDate ( ) 
tgGet 
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ft getMinAllowedQuerylnterval 

public long getMinAllowedQuerylnterval ( ) 
tgGet 

ft getXSLDocCount 

public int getXSLDocCount ( } 

return the number of XSL docs that have been assigned 

* getXsIDocs 

public Hashtable getXslDocsO 

Format the xslDocs Hashtable for use with the XMLPersister. to do this, the Document object must be converted to its xmi string 
representation 

ft getXSLDocument 

public org. w3c.dom. Document getXSLDocument (String name) 
return the XSLDocument assoc with this name. Null if none exists. 

ft getXSLName 

public String getXSLName (int idx) 
CI Return the Name associated with the given index position (0 based) in the hashtable. Null if not available 

%M removeXSLDocument 

8|>ublic void removeXSLDocument (String name) 
Remove the XSL document with this name from the list 

UM set Ad dress 

public void setAddress (String address) 

Cf *s Set 

flfft setDefauItMaxQuerySize 

©public void setDefauItMaxQuerySize (long maxQuerySize) 

M tgset 

ft setFormatter 

public void setFormatter (DataFormatter formatter) 
tgSet 

ft setLastCheckDate 

public void setLastCheckDate (long time) 
tgset 

ft setMinAllowedQuerylnterval 

public void setMinAllowedQuerylnterval ( long minAllowedQuery Interval) 

tgSet 
ft setXslDocs 

public void setXslDocs (Hashtable ht) 

Set the xslDocs Hashtable, It must be reformated because the getXslDocsO method reformats it for use with the XMLpersister. We must 
convert all hashtable string values back into Document objects 
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B Class ics.ain.infoserver.OuervNetResource 

public class QueryNetRe source 

This class is a singleton for a property resource bundle to be used by the Query Net Wizard. The resource bundle contains values that could 
potentially displayed to users. It also provides a direct, static method for safely getting String values without worrying about 
MIssingResourceExceptions ras; 2/29/99; modified by S. Levineon 9/9/99 



Attributes 

resourceBundle 

Operations 

getBundle() 

getString(String) 

initResourceBundleQ 




• resourceBundle 

private static ResourceBundle resourceBundle = null 
The resource bundle we keep for use by the package. 




ffy getBundle 

^public static ResourceBundle getBundle ( ) 

||| Return the single, static instance of the resource bundle for the SMPP Module 

rH» getString 

republic static String getString (String key) 

Pass through to the resourceBundle, except that we internally catch the MissingResourceException and report the error but return a T 

HI fll initResourceBundle 

I'll private static void initResourceBundle ( ) 
y Create the resource bundle 




Class tcs.ain.infoserver. Repository 



public class Repository 

Class for saving and retrieving UserAgents and QueryEngines. All of the elements owned by a UserAgent will be saved along with the object. 
This repository just used serialization for storage. More robust storage will be required in future versions. 



Attributes 

CrsrLoglntrv 
cursorCount 
cursorLimit 
jdbcConn 

QueryEngineDbName 

queryEngineHash 

userAgentHash 

Constructors 

RepositoryO 

Operations 

addQueryLngine(QueryEngine) 
addUserAgent(UserAgent, boolean) 
cursorAvailableO 
getDbConnectionQ 
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getQueryEngine(String) 

getQuery Engi ne(i nt) 

getQueryEngineCount() 

getQueryEngines() 

getUserAgent(String) 

getWorkeridsFromAgent(String) 

launchWorker(String, String) 

launchWorker(String, String, Hashtable) 

loadQueryEnginesQ 

loadUserAgentsQ 

makeDbConnection() 

re!easeCursor() 

saveQueryEngines() 

saveUserAgent(UserAgent) 

startWorkersO 

validateDbConnectionQ 




Wt CrsrLoglntrv 

protected static final int CrsrLoglntrv = QNServerRe source .getlnt ( "DbCursorLoglntrv" ) 
Amount of tries for a cursor to do before sending "WAITING FOR CURSOR" log message to stdout. 

& cursor-Count 

Gjprotected int cursorCount = 0 

M The database cursors currently open by repository. 

cursorLimit 

^protected static final int cursorLimit = QNServerRe source .getlnt { "DbCursorLimit « ) 
u] The database cursor limit for the Repository database connection. 

jdbcConn 

^protected Connection jdbcConn 

!!! The Repositories one and only database connection. 

pjld QueryEngineDbName 

□ public static final String QueryEngineDbName = "QueryEngine . so" 
P b Default name for the QueryEngine peristent storage 

» queryEngineHash 

protected Hashtable queryEngineHash = new Hashtable () 
QueryEngme(DataSource) table. Key is on QueryEngine Id 

A userAgentHash 

protected Hashtable userAgentHash = new Hashtable 0 
Agents table. Key is on Agent id 




a Repository 

public Repository 0 
Constructor 
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& addQueryEngine 

public void addQueryEngine (Que ryEngine ds) 
Add a new QueryEngine to repository 

Throws: 

I nf oServerException 

Parameter doc: 

ds QueryEngine(DataSource) to add 

Exception doc: 

tcs.ain.inloserver.lnfoServerException 

II add User Agent 

public void addUserAgent (UserAgent ua, boolean bStart) 

This adds a user agent to the repository. It does not necessary save the agent permanently. Call saveUserAgents for that, ua: UserAgent 
to add to system. bStart: whether or not to start new agent 

Throws: 

i nf oServerException 

!7l Parameter doc: 

i,fl ua User Agent Object 
CS bStart 

f|| Exception doc: 

|f| tcs.ain.infoserver.lnfoServerException 
^fl cursorAvailable 

f||>rivate boolean cursorAvailable ( ) 
™- Check to see if cursor limit has been reached 

flM getDbConnection 

flfmblic Connection getDbConnection ( ) 

J! Return a reference to jdbcConn if the CursorLimit has not been exceeded and a valid connection can be established, otherwise return null. 
Q This protects from exceeding the a given Database Implementation's cursor limit setting, it is the calling procedures responsibility to call 
release cursor when finished using the jdbcConn reference. Throws exception if unable to establish a valid database connection 

Throws: 

SQLException 

• getQueryEngine 

public QueryEngine getQueryEngine {String id) 
return the data source with this name, null 

Parameter doc: 

id QueryEngine Descriptor 

Return doc: 

QueryEngine(DataSource) Instance. 

# getQueryEngine 

public QueryEngine getQueryEngine { int idx) 
Get the data source with this index (0 based). 

Throws: 

I nf oServerException 
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Parameter doc: 

idx DataSource Index 

Return doc: 

QueryEngine(DataSource) instance. 

Exception doc: 

tcs, a i n . i nl os erver . I nf oServerExcepti on 

• getQueryEngineCount 

public int getQueryEngineCount ( ) 

Return the number of QueryEngines available from this repository. 

Return doc: 

QueryEngine Instance 

B; getQueryEngines 

public Hashtable getQueryEngines ( } 

ReturnsanenumerationofallavaiiabieQueryEngines. i 

Return doc: 

List of all QueryEngines. 

Cfl getUserAgent 

public UserAgent getUserAgent (String id) 

i^l Return the useragent with this ID. Return null if not found. 

HI Parameter doc: 

id Agent Descriptor 

Uj Return doc: 

QJ User Agent Instance. 

rf§ getWorkerldsFromAgent 

flpublic Vector getWorkerldsFromAgent (String agentld) 
l!f Return all id's associated with a specified agent 

f*\ Parameter doc: 

i„ 4 agentld Agent Descriptor 

Return doc: 

List of worker descriptors. 

• launchWorker 

public String launchWorker (String agentld, String workerld) 

Call the specidied workers doWork method this should be used in conjunction with the getWorkerldsFromAgent() method, this method 
should only be called if agent and corresponding worker are known to exists!!! 

Parameter doc: 

agentld Agent Descriptor 
workerld Worker Descriptor 

Return doc: 

Query Results. 

• launchWorker 

public String launchWorker (String agentld, String workerld, Hashtable htParams) 

Call the specidied workers doWork method this should be used in conjunction with the getWorkerldsFromAgent() method, this method 
should only be called if agent and corresponding worker are known to exists!!! 
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Parameter doc: 

agentld Agent Descriptor 
worker! d Worker Descriptor 

Return doc: 

Query Results. 

• loadQueryEngines 

public void loadQueryEngines () 

Throws: 

1 nf oServerException 

• loadUserAgents 

public void loadUserAgents () 

load UserAgent objects from USERAGENTS table and store in HashTabie 

Throws: 

I nf oServerExcepti on 

ft makeDbConnection 

private void makeDbConnection () 
p Make sure jdbcConn is valid, if not, report the error to out and return false 

vtl releaseCursor 

fjjpublic void releaseCursor ( ) 

y 1 Decrement cursorCount so that another process may reference jdbcConn 

hjl saveQueryEngines 

|S|?ublic void saveQueryEngines ( ) 
^ Save New QueryEngine(DataSource) to DB. 
m i Throws: 

r§ | I nf oServerExcepti on 
M Exception doc: 

Q tcs. a in.infoserver. I nf oServerException 

ft savellserAgent 

public void saveUser Agent (UserAgent ua) 

Serialize each user agent and store in binary field of USERAGENTS table) 

Throws: 

Inf oServerException 

Parameter doc: 

ua User Agent Object to Save 

Exception doc: 

tcs.ain.infoserver.lnfoServerException 

ft startWorkers 

protected void startWorkers ( ) 

Start each worker for each agent that was running when saved; called by loadUserAgents to get things back to where they were when 
saved 

ft validateDbConnection 

private void validateDbConnect ion ( ) 
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Make sure con is valid, if not, report the error to out and throw the exception 

Throws: 

SQLException 



B Class tcs. ain . infoserver. Search Filter 

public class SearchFilter 

Extends: 

tcs.ain. infoserver. DataFilter 

Implements: 

tcs.parser.SimpleSaxHandler 

Attributes 

attrStr 
ba 

bContinue 

endTags 

isVaiidContent 

newContent 

tag 

Operations 

£| assignVaiue(String) 
% endElement(String) 

getAttrStrO 
" E M getSaveables() 
m getTag() 
ii\ getXMLStream() 
^! moFilter(DataEvent, Hashtable) 
4* notifyDestinations(DataWorker, IDataSource) 
| a I processData(DataEvent) 
Si setAttrStr(String) 
w setSaveables(Object[]) 
- setTag(String) 
p startElement(String, String) 




Pll attrStr 

^protected String attrStr 



Attribute String to look for 

• ba 

protected ByteArraylnputStream ba 
Filtered Data Stream 

ft bContinue 

protected boolean bContinue = true 
Continue comparisons 

if endTags 

protected Vector endTags = new Vector () 

Used to determine when we have left the relm of desired content 

ft isVaiidContent 

protected boolean isVaiidContent = false 
Found desired content 
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• newContent 

protected StringBuffer newContent = new StringBuf fer (} 
Store filtered content 

• tag 

protected String tag 
Tag to search for 

WbMM §!SffXm : : 

• assignValue 

public void assignValue (String value) 
Called when a value within a tag set is processed. 

& endEIement 

public void endEIement (String name) 
Called when an tag element closes out 

• getAttrStr 

public String getAttrStr {) 

^ll getSaveables 

public Objectf] getSaveables ( ) 

J Return an array of ail objects that should be persistent, primitive datatypes must be converted to their Object equivalent. These objects 
r^! will come back in the same order when setSaveables is called. 

\M' 

Oil getTag 

^.public String getTag 0 
j% getXMLStream 

public InputStream getXMLStream { ) 

ft Return an input stream by which an XML document can be read. We return an INputStream rather than just a DOM XML document 
IT-? because: - some data may be too large to process as a single unit - this way multiple XML parsing techniques (SAX, DOM, etc) can be 
used at the discretion of the client The XML Stream does NOT included DTD info. 

Throws: 

I nf oServerException 

• moFilter 

public String moFilter (DataEvent evt, Hashtable htParams) 
Filter data from event and return 

• notifyDestinations 

protected void notif yDestinations (DataWorker dw, IDataSource ds) 
Execute processData() method of all member Destinations 

Throws: 

I nf oServerException 

ft processData 

public void processData (DataEvent evt) 

j have new data; Check to see if checksum value for data has changed 
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• setAttrStr 

public void setAttrStr (String attrStr) 

ft setSaveables 

public void setSaveables (Object [] oa) 

receive an array of objects that have been saved, the order will correspond to that specified when getSaveables was called. Users should 
handle Null values in the array. 

$ setTag 

public void setTag (String tag) 

• startEIement 

public void startEIement (String name, String paramStr) 

Called when a new tag element is being provided. elementName is the (capitalized) tag, and paramStr is the optional parameter list 

B Class tcs.ainJnfoserver.SearchFilter.XMLInputStream 

class XMLInputStream 

Extends: 

java.io.lnputStream 

"*;frhis handles access to the XML data through an input stream. Each object to request the inputstream gets one of these, which handles 
lending the data to the client from the bytearray data. Can be used by children at their discretion (e.g., if spooling cached data) 

yklAttributes 

111 lastPos 



^Operations 

read() 



■BBS 



bbiiii 



p lastPos 

*dnt lastPos 



• read 

public int readO 

Throws: 

lOException 



H Class tcs.ain.infoserver.servletAddEditServicesPage 

public class AddEditServicesPage 
Extends: 

tcs.ain.infoserver.servlet.infoSvrPage 



Attributes 

access 

action 

agent 

step 

stepList 

testld 
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Constructors 

AddEditServicesPage(HttpServletRequest, HttpServletResponse, IRemoteRepository, UserAgent) 

Operations 

cieanUpSessionO 
doCustAgenlStepO 
doCustSourceStepO 
doDestStep() 

dolntroStepO 

doNewSourceStep() 

doPubiicSourceStepO 

doSelectWorkerStepO 

getBody() 

GetPageldO 

processWizardForm(DataWorkerWizardForm, boolean, boolean) 
syncStepList(Vector, String) 



ute Detail 



• access 

protected IRemoteRepository access 

• action 

^protected String action 



; j» agent 

.^protected UserAgent agent 



m 



yM step 

! ^protected String step = null 



stepList 

^protected Vector stepList 

O testid 

^protected String testid 




ft AddEditServicesPage 

public AddEditServicesPage (HttpServletRequest request, HttpServletResponse 
IRemoteRepository access, UserAgent agent) 

Constructor calls superQ and sets the title for this page 



response, 



on Detail 



mmmm. 



ft- cleanUpSession 

protected void cleanUpSession ( ) 



ft doCustAgentStep 

protected void doCustAgentStep ( ) 



ft doCustSourceStep 

protected void doCustSourceStep ( ) 
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• doDestStep 

protected void doDestStepO 

<l dolntroStep 

protected void dolntroStep { ) 

• doNewSourceStep 

protected void doNewSourceStep ( ) 

9 doPublicSourceStep 

protected void doPublicSourceStep { ) 

• doSelectWorkerStep 

protected void doSelectWorkerStep ( ) 

• get Body 

public String getBodyO 

Return the page's body. For increased efficiency, this directly writes to the response output and does not actually return any data. 

& Get Pa geld 

Qublic static int GetPageldO 

;# processWizardForm 

Wjlrotected String processWizardForm (DataWorkerWizardForm wizardForm, boolean doProcess, boolean 
^AoPrint ) 

Mil syncStepList 

protected void syncStepList (Vector list, String currStep) 

%i Return the page's body. For increased efficiency, this directly writes to the response output and does not actually return any data. 

[til Class tcs.ain.infoserver.servlet CreateNewSourceForm 

Spublic class CreateNewSourceForm 
yExtends: 

tcs. ai n . i nf oserver. servlet. DataWorkerWiza rdForm 
Define the Data Sources that are desired. 

Attributes 

debug 
HtmiPage 
request 
test Id 

Constructors 

CreateNewSourceForm(HttpServletRequest, IRemoteRepository, String) 
Operations 

getCustomSource(String, StringBuffer) 

getForm() 

getSourceO 

getTagTabie() 

populateFormFromWorkerO 

popuiateWorkerFromFormO 

printCustomForm(String) 

processCustomSource(StringBuffer) 

setDebug(boolean) 
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Attribute Detail 



• debug 

private boolean debug = true 
For Internal Debugging 

& HtmlPage 

protected static StringBuffer HtmlPage 

Stores Html Page associated with a form producing class 

<l request 

protected HttpServletRequest request 
HttpServletRequest 

m testld 

protected String testld 

Stores error messages recieved from creating a new source 




,fP CreateNewSourceForm 

public CreateNewSourceForm (HttpServletRequest request, IRemoteRepository access, String stepDesc) 
¥jf Constructor 

: -iris 

■*% getCustomSource 

^protected QueryEngine getCustomSource (String source, StringBuffer errorMsg) 
f|| Get a new Custom DataSource from the ISElementCreator Implementation 

|4> getForm 

P|>ublic String getForm () 

Return the appropriate form for adding new workers or selecting existing workers 

9t getSource 

protected String getSource () 

get selected source name from request object 

It getTagTable 

protected Hashtable getTagTable ( ) 

Create a table of tags and their values to be used in replacing tags found in static html pages. Used to add dynamic content to these 
pages. 

9 populateFormFromWorker 

protected void populateFormFromWorker ( ) 

Populate the form fields with values from the DataWorker 

ft populateWorkerFromForm 

public String populateWorkerFromForm ( ) 

Populate the DataWorker with data assigned to the form 
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$ printCustomForm 

protected String printCustomForm {String source) 

• processCustomSource 

protected void processCustomSource (StringBuffer errorMsg) 
Handle logic flow of creating a new custom datasource 

setDebug 

public void setDebug (boolean b) 

Return the appropriate form for adding new workers or selecting existing workers 

6 Class fcs. ain.infoserver. servlet Custom izeAgentForm 

public class Customize Agent Form 
Extends: 

tcs.ain.infoserver.servlet.DataWorkerWizardForm 
Define the Data Sources that are desired. 

Attributes 

..- desc 

C| dom 

ill dom index 

;T\ domTable 

J;f dow 

III dow Index 

HI dowTable 

"fi hour 

hourindex 

Ml hourTable 

m HtmlPage 

minute 

^. minutelndex 

CI minuteTable 

11 1 new Id 

m testid 
^Constructors 

O CustomizeAgentForm(HttpServietRequest, IRemoteRepository, String) 

! Operations 

addTimerValues(String[], Hashtable, TimeElement) 

createDomlndexO 

createDomTable() 

createDowlndex() 

createDowTab!e() 

createHourlndexO 

createHourTable() 

createlndex(Vector, String) 

createM i n utei ndex() 

create M i n uteTa b 1 e() 

getForm() 

getTagTable() 

popuiateFormFromWorkerO 

popuiateWorkerFromFormO 

saveToRepository() 

setAgentPropetiesO 

setCustomTimer() 

writeSeiectBox(String, Hashtable, Vector, TimeElement) 



$ desc 
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protected String desc 

• dom 

protected String [] dom 

© domlndex 

protected static Vector domlndex = null 

• domTable 

protected static Hashtable domTable = null 

• dow 

protected String [] dow 

& dowlndex 

protected static Vector dowlndex = null 

• dowTable 

protected static Hashtable dowTable = null 

f ^ hour 

yj!Sprotected String [] hour 

Bjifl hourlndex 

y 'protected static Vector hourlndex = null 

WH hourTable 

protected static Hashtable hourTable = null 

O* Htm I Page 

protected static StringBuffer HtmlPage 

Stores Html Page associated with a form producing class 

■Wt minute 

protected String [3 minute 

& minutelndex 

protected static Vector minutelndex = null 

• minuteTable 

protected static Hashtable minuteTable = null 

• newld 

protected String newld 

• testld 

protected String testld 



Si CustomizeAgentForm 

public CustomizeAgentForm (HttpServletRequest request, IRemoteRepository access, String stepDesc) 
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Constructor 



• addTimerValues 

protected void addTimerValues (String [] timerValues, Hashtable table, TimeElement timeElement) 

• createDomlndex 

protected static void createDomlndex ( ) 

ft createDomTable 

protected static void createDomTable ( ) 

Create a table to hold Day of Month options to be displayed to user as well as the corresponding TimeElement values 

ft createDowlndex 

protected static void createDowlndex ( ) 

ft createDowTable 

protected static void createDowTable ( ) 

Create a table to hold Day of Week options to be displayed to user as well as the corresponding TimeElement values 

createHourlndex 

.^protected static void createHourlndex ( ) 
Wjft createHourTable 

^protected static void createHourTable ( ) 

m Create a table to hold Hout options to be displayed to user as well as the corresponding TimeElement values 
■L,ft createlndex 

SSprotected static void createlndex (Vector vlndex, String property) 

f|| /create vector list of possible index value for the specified index from the specified 

f*% /resource string. 

^■ft createMinutelndex 

protected static void createMinutelndex { 5 

ft create M in uteTabie 

protected static void createMinuteTable ( ) 

Create a table to hold Minute options to be displayed to user as well as the corresponding TimeElement values 

ft getForm 

public String getForm () 

Return the appropriate form for adding new workers or selecting existing workers 

ft getTagTable 

protected Hashtable getTagTable ( ) 

Create a table of tags and their values to be used in replacing tags found in static html pages. Used to add dynamic content to these 
pages. 

ft populateFormFromWorker 

protected void populateFormFromWorker ( ) 

Populate the form fields with values from the DataWorker 
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• populateWorkerFromForm 

public String populateWorkerFromForm ( } 

Populate the DataWorker with data assigned to the form 

• saveToRepository 

public void saveToRepository {) 

• setAgentPropeties 

protected void setAgentPropeties ( ) 

® setCustornTimer 

protected String setCustornTimer ( ) 

• writeSelectBox 

protected String writeSelectBox (String name, Hashtable table, Vector index, TimeElement 
timeElement) 

H Class tcs.ain. infoserver.servlet CustomSourceForm 

public class CustomSourceForm 
^Extends: 

*J| tcs.ainJnfoserver.servlet.DataWorkerWizardForm 
J^J Define the Data Sources that are desired. 

^^Attributes 

HtmlPage 
111 request 

^Constructors 

JU CustomSourceForm(HttpServletRequest, IRemoteRepository, String) 
fUOperations 

fll. getAvailableDSO 
Q getForm() 

getTagTable() 
H populateFormFromWorker() 
H populateWorkerFromFormQ 




• HtmlPage 

protected static StringBuffer HtmlPage 

Stores Html Page associated with a form producing class 

• request 

protected HttpServlet Request request 




• CustomSourceForm 

public CustomSourceForm (HttpServletRequest request, IRemoteRepository access, String stepD 
Constructor 
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ft getAvailableDS 

protected String getAvailableDS ( ) 

create select box for available datasources and store in buffer 

• getForm 

public String getForm () 

Return the appropriate form for adding new workers or selecting existing workers 

• getTagTable 

protected Hashtable getTagTable () 

Create a table of tags and their values to be used in replacing tags found in static html pages. Used to add dynamic content to these 
pages. 

» popuIateFormFromWorker 

protected void popuIateFormFromWorker ( ) 
Populate the form fields with values from the DataWorker 

ft populateWorkerFromForm 

Qpublic String populateWorkerFromForm () 



'f\ Edit Data Worker based on user request 



{JIB Class tcs.ain/mfoserver.servletDataSourceForm 

4-public class DataSourceForm 
W Extend s: 



tcs.ain.infoserver.servlet.DataWorkerWizardForm 



[Attributes 

$ request 

fi! 

^Constructors 

t?5 DataSourceForm(]avax.servlet.http.HttpServletRequest f tcs.ain.infoserver.access.lRemoteRepository, java.lang.String) 

^Operations 

getAvailableDSO 
getForm() 

parseComment(java.lang, String) 

parseDataSource(java.lang.String) 

populateFormFromWorker() 

populateWorkerFromForm() 

processDataSourceQ 



@ request 

protected javax. servlet .http.HttpServletRequest request 



H DataSourceForm 



public DataSourceForm ( javax. servlet .http.HttpServletRequest , 
tcs . ain. inf oserver . access . IRemoteRepository , java . lang . String) 
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• getAvailableDS 

protected void getAvailableDS ( ) 

• getForm 

public java.lang.String getForm () 

• parseComment 

protected java.lang.String parseComment (java. lang. String) 

• parseDataSource 

protected java.lang.String parseDataSource (java.lang.String) 

$ populateFormFromWorker 

protected void populateFormFromWorker ( ) 

& popuIateWorkerFromForm 

publ ic j ava . lang .String popuIateWorkerFromForm ( ) 

,M processDataSource 

^ public void processDataSource ( } 



*B Class tcs.ain.infoserver. servlet Data Worker Form 

Jjpublic class DataWorkerForm 
Wfextends: 

flf tcs.ain.infoserver. servlet. DataWorkerWizardForm 
% Define the Data Sources that are desired. 

^Attributes 

111 HtmiPage 
n selectWorker 
5| testid 

^Constructors 

DataWorkerForm(HttpServletRequest, IRemoteRepository, String) 

Operations 

getForm() 

getTagTable() 

getWorkerOptionsO 

getWorkersFormO 

popu!ateFormFromWorker() 

populateWorkerFrom FormQ 



Hllll 



nn 



• HtmiPage 

protected static StringBuffer HtmiPage 

Stores Html Page associated with a form producing class 

• selectWorker 

protected String selectWorker 
Name of Selected worker to be edited 
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m testld 

protected String testld 
Id to be used for script testing only 



• DataWorkerForm 

public DataWorkerForm(HttpServletRequest request, IRemoteRepository access, String stepDesc) 
Constructor 



• getForm 

public String getForm () 

Return the appropriate form for adding new workers or selecting existing workers 

& getTagTable 

protected Hashtable getTagTable () 

Create a table of tags and their values to be used in replacing tags found in static html pages. Used to add dynamic content to these 
pages. 

%9k getWorkerOptions 

lljbrotected String getWorkerOptions ( ) 

getWorkersForm 

protected void getWorkersForm ( ) 

!' r Create an html form for selecting or removing existing Data Workers. This is the initial form for the Query Net Wizard 

populateFormFromWorker 

^protected void populateFormFromWorker () 

P| Populate the form fields with values from the DataWorker 

0(1 populateWorkerFromForm 

public String populateWorkerFromForm () 

Populate the DataWorker with data assigned to the form 

B Class tcs.ainJnfoserver.servletDataWorkerWizardForm 

public abstract class DataWorkerWizardForm 

Base class for elements that will show info about a DataWorker Subclasses will access each component that a DataWorker cares about 

Attributes 

action 
agent 
buffer 

errorMessage 

repository 

session 

testld 

worker 

Constructors 

DataWorkerWizardForm(HttpServletRequest, IRemoteRepository, String) 
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Operations 

getForm() 

getHtmlPage(String) 

populateFormFromWorker() 

popuiateWorkerFromFormO 

printJavaScript() 
replaceTags(String, Hashtabie) 



ft action 

protected String action 

ft agent 

protected UserAgent agent 
ft buffer 

protected StringBuffer buffer 
ft- errorMessage 

protected String errorMessage = 

jaws; 

^jft repository 

protected IRemoteRepository repository 

Jffft session 

^protected HttpSession session 

||» testld 

""protected String testld 
O Used for testing scripts only 

ffjft worker 

rlprotected DataWorker worker 



a DataWorkerWizardForm 

public DataWorkerWizardForm(HttpServletRequest request, IRemoteRepository r 
Constructor 



ft getForm 

public abstract String getForm () 
Return the HTML string that defines the form 

ft getHtmlPage 

public StringBuffer getHtmlPage (String path) 

Read in specified Html Page and store to static HtmlPage StringBuffer 

Throws: 

Exception 
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• populateFormFromWorker 

protected abstract void populateFormFromWorker (} 
Populate the form fields with values from the DataWorker 

• populateWorkerFromForm 

public abstract String populateWorkerFromForm () 
Populate the DataWorker with data assigned to the form 

d printJavaScript 

public String printJavaScript ( ) 

java script for create pop up browser for displaying help info 

• replaceTags 

public String replaceTags (String content, Hashtable 
Read in specified Html Page and store content to StringBuffer 

Throws: 

Exception 

□ B Class tcs.ain.infoserver.servlet. Destination Form 

ilpublic class DestinationForm 
Extends: 

^ tcs.ain.infoserver.servletDataWorkerWizardForm 
"if. Define the Data Sources that are desired. 

^Attributes 

bNotifyChangeOniy 
% dataSourco 
H destStore 
fi\ HtmlPage 
:J: request 
HI testld 

*S% Constructors 

y, DestinationForm(HttpServietRequest, JRemoteRepository, String) 

Operations 

addDestination(String, IDataEventSource) 

addToListO 

getDestination(String) 

getForm() 

getTagTable() 

initListO 

popuiateFormFromWorkerQ 

populateWorkerFromFormO 

printAvailDestList() 

printCurrDestList() 

printNotifyChangeBoxO 

printRequired! nf o(String) 

printStyles(String) 

printStyleSection() 

processAlwaysNotifyO 

processDestinations() 

process NotifyCh a ngeOnlyQ 

removeDestinations(iDataEventSource) 

removeFromListQ 
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ft bNotifyChangeOnly 

protected boolean bNotifyChangeOnly = false 
9 dataSource 

protected QueryEngine dataSource = null 

* destStore 

protected Vector destStore = null 
m HtmlPage 

protected static StringBuffer HtmlPage 

Stores Html Page associated with a form producing class 

ft request 

protected HttpServletRequest request = null 

m testld 

protected String testld = null 




• DestinationForm 



^public DestinationForm(HttpServletRequest request, IRemoteRepository access, String stepDesc) 
y| Constructor 



1 Operation D&t 



^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ 



addDestination 

protected String addDestination (String destination, IDataEventSource iDes) 
m Add a destination to Data Worker 



•( addToList 

public void addToList () 

Add new destinations to destStore Vector and store into session obj 

% getDestination 

protected UserDeliveryDestination getDestination (String destld) 
Return requested destination. 

• getForm 

public String getForm () 

Return the appropriate form for adding new workers or selecting existing workers 

• getTagTable 

protected Hashtable getTagTable ( ) 

Create a table of tags and their values to be used in replacing tags found in static html pages. Used to add dynamic content to these 
pages. 
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• initList 

protected void initList {) 
Initialize destStore 

$ populateFormFromWorker 

protected void populateFormFromWorker ( } 

Populate the form fields with values from the DataWorker 

• populateWorkerFromForm 

public String populateWorkerFromForm () 

Populate the DataWorker with data assigned to the form, or temporarily store. 

• printAvailDestList 

protected String printAvailDestList ( ) 

Create an html Select box and populate with available destinations 

© printCurrDestList 

protected String printCurrDestList () 

Create an html Select box and populate with currently selected destinations 

printNotifyChangeBox 

^protected String printNotifyChangeBoxO 

10 Create an html CheckBox for "Notify if Change Only" option 

ill 

jMfll printRequiredlnfo 

hjprotected String printRequiredlnfo (String destld) 
U! Create a text box and prompt for required info for a given destination 

pi printStyles 

flfprotected String printStyles (String destld) 

III Create and populate a drop down box with available style options for a give data sources 

CSW printStyleSection 

^protected String printStyleSection ( ) 

Create table rows dynamically based on Data Source info 

9t processAlwaysNotify 

protected String processAlwaysNotif y ( } 
Add all destinations to Data Worker 

• processDestinations 

public String processDestinations ( ) 
process selected destinations * 

9 processNotifyChangeOnly 

protected String processNotif yChangeOnly ( ) 

Add destinations to NotifyChangeOnlyDestination, then add NotifyChangeOnlyDestination to Worker 

• removeDestinations 

protected void removeDestinations (IDataEventSource des) 
Remove destination from Data Worker 
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■f removeFromList 

public void removeFromList ( ) 

Remove selected destinations from destStore Vector 



H Class tcs. a in. infoserver. serviet InfoSvrMain 

public class InfoSvrMain 

Extends: 

tcs.web.WebMain 

This is the Main page for the Info Server Web Application. This loads pages according to the received Section variable 

Attributes 

CrsrLoglntrv 

cursorCount 

cursorLimit 

infoServerAccess 

jdbcConn 

MainApp 

sessions 

Constructors 

lnfoSvrMain() 

^pperations 

cursorAvailable() 
% ;f getDbConnection() 
£0 getRMlConnection() 
j|! getSessionObj(Object) 

getWebPagePrinter(WebPage) 

IoadSection(HttpServletRequest f HttpServtetResponse) 
U| makeDbConnectionQ 
g| makeRMIConnection() 
^ putSessionObj(Object, Object) 

reieaseCursor() 
Cl removeSessionObj(Object) 
fl| showDBError(HttpServletResponse) 
ft* showRMIError(HttpServIetResponse) 
l:f validateDbConnection() 
fcf validateRMIConnectionQ 




& CrsrLoglntrv 

protected static final int CrsrLoglntrv = QNServlet Re source .getlnt { "DbCursorLoglntrv" ) 
Amount of tries for a cursor to do before sending "WAITING FOR CURSOR" log message to stdout. 

* cursorCount 

protected static int cursorCount = 0 
The database cursors currently open by repository. 

• cursorLimit 

protected static final int cursorLimit = QNServlet Re source .getlnt ( "DbCursorLimit " ) 
The database cursor limit for the Repository database connection. 

(i infoServerAccess 

protected static IRemoteRepository infoServerAccess = null 

Remote InfoServer Access Repository for loading / saving User Agents and Sources. Accessed via RM! 

<l jdbcConn 
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protected static Connection jdbcConn 

JDBC Connection for querying provisioning information from database 

• MainApp 

public static String MainApp = QNServletResource .getString { "MainAppPath" } 

• sessions 

private static Hashtable sessions 

used for script load testing where regular session objects are not available 




• InfoSvrMain 

public InfoSvrMain {) 




• cursorAvailable 

protected static boolean cursorAvailable ( ) 
O Check to see if cursor limit has been reached 

SjjH getDbConnection 

0|>ublic static Connection getDbConnection {) 

W Return a reference to jdbcConn if the CursorLimit has not been exceeded and a valid connection can be established, otherwise return i 
4* This protects from exceeding the a given Database Implementation's cursor limit setting. It is the calling procedures responsibility to 
hi release cursor when finished using the jdbcConn reference. Throws exception if unable to establish a valid database connection 

m Throws: 

SQLException 

flJSI getRMIConnection 

public static IReraoteRepository getRMIConnection ( ) 

SI Connect the remote object to the server if necessary and return RMi Connection 

fch Throws: 

Exception 

• getSessionObj 

public static Object getSessionObj {Object key) 
Use this instead of session object when script testing 

• getWebPagePrinter 

public WebPagePrinter getWebPagePrinter {WebPage wp) 

Connect the remote object to the server if necessary and return RMI Connection 

Throws: 

Exception 

• loadSection 

protected void loadSection {HttpServletRequest request, HttpServletResponse response) 

Evaluate the 'Section' value and load the appropriate page. If Section is not set, then just ioad the MONTHVIEW_PAGE page 
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• makeDbConnection 

protected static void makeDbConnection ( } 

Make sure jdbcConn is valid. If not, report the error to out and return false 

Throws: 

SQLException 

& makeRMIConnection 

protected static void makeRMIConnection ( ) 
Connect the remote object to the server if necessary 

Throws: 

Exception 

& putSessionObj 

public static void putSessionObj (Object key, Object value) 
Use this instead of session object when script testing 

9 releaseCursor 

public static void releaseCursor ( ) 
^ Decrement cursorCount so that another process may reference jdbcConn 

tflft removeSessionObj 

^fpublic static Object removeSessionObj (Object key) 
ijjfl Use this instead of session object when script testing 

showDBError 

SJprotected static void showDBError (HttpServletResponse response) 
~; Display a spiffy RMi error message 
ml9t showRMIError 

tljprotected static void showRMIError (HttpServletResponse response) 
El Display a spiffy RMi error message 

Uflf validateDbConnection 

protected static void validateDbConnection () 

Make sure con is valid. If not, report the error to out and throw the exception 

Throws: 

SQLException 

Wt validateRMIConnection 

protected static void validateRMIConnection ( ) 

make connection if necessary; test the connection; if failed, try to to remake the connection return true if good connection 

B Class tcs. a in . infoserver. servlet. InfoSvrPaze 

public abstract class InfoSvrPage 

Extends: 

tcs.web.WebPage 



Attributes 

userAgent 
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Constructors 

infoSvrPage(HttpServletRequest, HttpServietResponse, UserAgent) 

Operations 

getHtmlPage(String) 
replaceTags(String, Hashtable) 



# userAgent 

protected UserAgent userAgent 



• InfoSvrPage 

public InfoSvrPage (HttpServletRequest req, HttpServietResponse res, UserAgent agent) 
Stores Htmi Page associated with a form producing ciass 



HI 



getHtmlPage 

^public StringBuffer getHtmlPage (String path) 

^ 

J;f Read in specified Html Page and store to static HtmiPage StringBuffer 

iff Throws: 
12 Exception 

replaceTags 

w public String replaceTags (String content, Hashtable ht) 

Cl Read in specified Html Page and store content to StringBuffer 

l%l Throws: 
t:f Exception 

k B Class tcs.ain.infoserver.servlet ISEIementCreatorException 

public class ISEIementCreatorException 
Extends: 

tcs.ain.infoserver.servlet.lSServletException 

Constructors 

ISEtementCreatorException(String) 



• ISEIementCreatorException 

public lSElementCreatorException(String s) 



B Class tcs. ain . infoserver. servlet ISEIementLoader 

public class ISEIementLoader 

Attributes 

creator 
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resourceBundle 

Operations 

getBundleO 
getCreatorO 
initResourceBundleQ 



• creator 

protected static ISElementCreator creator = null 

• resourceBundle 

protected static ResourceBundle resourceBundle = null 



* getBundle 

private static ResourceBundle getBundleO 

Return the single, static instance of the resource bundle for the SMPP Module 

I3» getCreator 

tffpublic static ISElementCreator getCreator () 
nfl Throws: 

i*\ ClassNotFoundException 
%; instantiationException 
#* IHegalAccessException 

6!# initResourceBundle 

'^private static void initResourceBundle ( ) 
m Create the resource bundle 



O B Class tcs.ain.infoserver.servlet.lSServletException 

J^f public class ISServletException 

Extends: 

java.lang.Exception 

Constructors 

!SServletException(String) 



Constructor DGtati 
G* ISServletException 

public ISServletException (String s) 



B Class tcs.ain.infoserver.servlet.LoginPage 

public class LoginPage 
Extends: 

tcs.ain.inloserver.servlet.lnfoSvrPage 
USER LOGIN PAGE. This prompts user for username/pw and tries and to find (or create) a UserAgent object for them. The UserAgent object 
is inserted into the user's Session under the name 'userAgent', for retention between screens This will eventually validate against and 
reference the SMS Internet Suite Userinfo database. Note: New agents are created for authenticated users, and their WebProv values will be 
assigned to the agent for name, email, mm We will need to keep the agent info up-to-date somehow. 
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Attributes 

access 
Htm I Page 
password 
test Id 
username 

Constructors 

LoginPage(HttpServletRequest, HttpServietResponse, IRemoteRepository) 

Operations 

createNewAgent(ResuitSet) 
getBodyO 
getinvalidLogin() 
getLoginForm() 

GetPageidO 

isVaiidLogin(ResultSet) 

print() 

processLoginO 
queryliserlnfoDBO 
syncAgent(ResultSet, UserAgent) 



• access 

C|)rotected IRemoteRepository access 
^! How we obtain Agents 

W» HtmlPage 

^jjprotected static StringBuffer HtmlPage 

Stores Html Page associated with a form producing class 



^*9t password 

^protected String password 



^|5» testld 

f : |protected String testld 
i^m username 

protected String username 
• LoginPage 

public LoginPage (HttpServlet Request request, HttpServletResponse response, IRemoteRepository 
access) 

Constructor calls superQ and sets the title for this page 



• createNew Agent 

protected UserAgent createNewAgent (ResultSet r) 

Create a new UserAgent based on information we can get from the UserProvisioning database for the login name 

• getBody 

public String getBodyO 
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Return the page's body 

• getlnvaiidLogin 

protected String getlnvaiidLogin ( ) 

Return String describing that the login/pw were invalid 

• getLoginForm 

protected String getLoginForm ( ) 

Show the login form. When accepted, this page will get called again, but then it will process 

• GetPageld 

public static int GetPageld () 

$ isValidLogin 

protected boolean isValidLogin (ResultSet r) 
Autherticate the user. 

• print 

public void print () 

Ensure that pagePrint is set to not print banner 

Jp processLogin 

Sjprotected String processLogin ( ) 

W process the login; if acceptable, stick in the Session and show Welcome Page 
49* queryUserlnfoDB 

Unprotected ResultSet queryUserlnfoDB (} 

m Query the UserProvisioning database for the login name 

P • syncAgent 

^protected void syncAgent (ResultSet r, UserAgent agent) 
1^1 Make sure agent info is up to date with provisioning information. 

Xfft J 

fear 

H B Class tcs.ainJnfoseiver.servletMainMenuPaze 

public class MainMenuPage 
Extends: 

tcs.ain.infoserver.servlet.lnfoSvrPage 
MAIN MENU PAGE. This will provide the main options for the app. 

Attributes 

Html Page 
SiteVec 

Constructors 

MainMenuPage(HttpServletRequest, HttpServietResponse, UserAgent) 

Operations 

getBodyO 

getPageDescription() 

GetPageldO 

getSiteVecQ 
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Attribute Detail 
m Html Page 

protected static StringBuffer HtmlPage 

Stores Html Page associated with a form producing class 

• SiteVec 

protected static Vector SiteVec = new Vector {) 

This contains a central list of the site account names. Referenced elsewhere, but just populated here 

_ ; r 

• MainWIenuPage 

public MainMenuPage(HttpServletRequest request, HttpServletResponse response 
Constructor calls super() and sets the title for this page 

• getBody 

Ppublic String getBody {) 
the page body 

Oil getPageDescription 

public String getPageDescription ( ) 
7j This returns the special page description. 

isjtt, 

GetPageld 

Ipublic static int GetPageld () 
j}f* getSiteVec 

public static Vector getSiteVecO 
Q Return the static vector of available sites 

H Class tcs. ain.infoserver. servlet PubticSourceForm 

public class PublicSourceForm 
Extends: 

tcs.ain.infoserver.servlet.DataWorkerWizardForm 
Define the Data Sources that are desired. 

Attributes 

HtmlPage 
request 
test Id 

Constructors 

PublicSourceForm(HttpServ!etRequest t IRemoteRepository, String) 

Operations 

getAvailableDSO 
getFormO 
getTagTable() 
parseDataSource(String) 
populateFormFromWorkerO 
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populateWorkerFromFormO 
processDataSourceQ 



tail 



ft Html Page 

protected static StringBuf fer HtmlPage 

Stores Html Page associated with a form producing class 

ft- request 

protected HttpServletRequest request 
Request object 

ft testld 

protected String testld 
Used for testing via scripts only 



II PublicSourceForm 

public PublicSourceForm(HttpServletRequest request, IRemoteRepository access, String stepDesc) 

tony. 

„- : s Constructor 



jip getAvaiiableDS 

3|)rotected String getAvaiiableDS { ) 

~L create select box for available datasources and store in buffer 

lift getForm 

„!:public String getForm {) 

S Return the appropriate form for adding new workers or selecting existing workers 
""ft getTagTable 

protected Hashtable getTagTable { ) 

Create a table of tags and their values to be used in replacing tags found in static html pages. Used to add dynamic content to thes 
pages. 

SI parseDataSource 

protected String parseDataSource (String source) 

Remove comment from destination. Comment is delimited with ":* in front ex./ parseDestinationfEMAIL: This is a public email 
destination.") returns "EMAIL" 

ft popuIateFormFromWorker 

protected void popuIateFormFromWorker ( ) 

Populate the form fields with values from the DataWorker 

ft populateWorkerFromForm 

public String populateWorkerFromFormO 
Edit Data Worker based on user request 



Page 169 of 326 



$ processDataSource 

public void processDataSource ( ) 
Edit Data Worker based on user request 



B Class tcs.ain.infoserver.servlet.QNServiceCreator 

public class QNServiceCreator 

Implements: 

tcs.ain.infoserver.servtet.iSEIementCreator 

S. Levine on 11/1/99 



Attributes 

customSourcesDb 
debug 

destinationsDb 

STARTREF 

URL 

Constructors 

QNServiceCreatorO 

Operations 

I getAttribute(String, String, int) 

| getAttribute(String, String) 

\ getAttribute(String, int, String) 

f getChatDestination(String, Vector, StringBuffer) 

J getCustEmailSourceForm(String, InfoServerEiement, UserAgent) 

1 getCustomEmailSource(String, HttpServletRequest, StringBuffer) 

* getCustomSource(String, HttpServletRequest, StringBuffer) 

! getCustomWebSource(String, HttpServietRequest, StringBuffer) 

I getCustWebSourceForm(String, InfoServerEiement, UserAgent) 

1 getDestination<String, Vector, StringBuffer) 

getElementNames(int, boolean) 
+ getEmailDestination(String, Vector, StringBuffer) 
I getFormatStyle(UserDeliveryDestination) 
I getFormatter(QueryEngine, String) 
i getMinFromFieid(String, String) 
1 getReqChatDestlnfo(lnfoServerEiement, UserAgent) 
I getReqEmailDestlnfo(lnfoServerElement, UserAgent) 
! getReqEmailSourcelnfo(lnfoServerElement, UserAgent) 

getReqSMSDestlnfo(lnfoServerEiement, UserAgent) 

getRequiredData(String, InfoServerEiement, UserAgent, int) 

getRequirements(String, int) 

gets i m p I eDesti nati on(St ri ng, St ri ngB uf f er) 

getSMSDestination(String, Vector, StringBuffer) 

getStyles(String, int) 

getSubForm(String, InfoServerEiement, UserAgent, int) 

isVandHostName(String) 

loadElements(String, String) 

rateReliability(String) 

returnDbType(int) 

validMin(String) 

9 customSourcesDb 

private Hashtable customSourcesDb = null 
Store custom source elements. 

• debug 

private static final boolean debug = true 



For Internal Debugging 
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© destinationsDb 

private Hashtable destinationsDb = null 
Store Destination elements. 

m STARTREF 

private static final String STARTREF = QNConst . EDT_J?REFIX + "STARTREF" 
Name of uri f ieid Create Web Source Form 

#URL 

private static final String URL = QNConst . EDT_PREFIX + "URL " 
Name of url field Create Web Source Form 



• QNServiceCreator 

public QNServiceCreator ( ) 

Return the single, static instance of the resource bundle for the SMPP Module 

getAttribute 

^protected String getAttribute (String name, String attr, int elementType) 

111 Return the attribute from an Element Conf ig String given the element name, attribute, and elementType. 

getAttribute 

Blprotected String getAttribute (String conf igString, String atName) 
I Return the attribute from an Element Config String given the string, and the attribute. 

o 

Km getAttribute 

^private Vector getAttribute (String name, int elementType, String attr) 
35 Return Parsed Attribute String, and return elements in a vector 

**** getChatDestination 

private ChatUserDestination getChatDestination (String destination, Vector reqlnfo, StringBuffer 
errorMsg) 

Load elements descriptions from resource file into hashtables 

ft getCustEmailSourceForm 

protected String getCustEmailSourceForm (String name, Inf oServerElement element, UserAgent agent) 
Get form components necessary in creating the specifed element 

H getCustomEmailSource 

private NewEmailQueryEngine getCustomEmailSource (String source, HttpServletRequest request, 
StringBuffer errorMsg) 

Load elements descriptions from resource file into hashtables 

• getCustomSource 

public QueryEngine getCustomSource (String source, HttpServletRequest request, StringBuffer 
errorMsg) 

Load elements descriptions from resource file into hashtables 
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ft getCustomWebSource 

private QueryEngine getCustomWebSource (String source, HttpServletRequest request, StringBuffer 
errorMsg) 

Load elements descriptions from resource file into hashtables 
ft getCustWebSourceForm 

protected String getCustWebSourceForm (String name, Inf oServerElement element, UserAgent agent) 

Get form components necessary in creating a web datasource 
ft getDesti nation 

public UserDeliveryDestination getDestination (String destination, Vector reqlnfo, StringBuffer 
errorMsg) 

Load elements descriptions from resource file into hashtables 
ft getElementNames 

public Vector getElementNames (int elementType, boolean addDesc) 
return list of elements descriptions from specified hashtabie 

ft getEmailDestination 

private EmailUserDestination getEmailDestination (String destination, Vector reqlnfo, StringBuffer 
tljerrorMsg) 

?H Load elements descriptions from resource file into hashtables 

getFormatStyle 

^t|>ublic String getFormatStyle (UserDeliveryDestination dest) 
7,1 Return the name of the XSL format being used by this destination 

getFormatter 

^public DataFormatter getFormatter (QueryEngine ds, String style) 
f|| Load elements descriptions from resource file into hashtables 

lift getMinFromField 

^protected String getMinFromField (String value, String srchFld) 

'its? 

w try to lookup and return the MIN from the Userinfo table using the recvd search field returns null if not found 
ft getReqChatDestlnfo 

protected Vector getReqChatDestlnfo (Inf oServerElement element, UserAgent agent) 
ft getReqEmailDestlnfo 

protected Vector getReqEmailDest Inf o ( Inf oServerElement element, UserAgent agent) 

ft- getReqEmailSourcelnfo 

protected Vector getReqEmailSourcelnfo (Inf oServerElement element, UserAgent agent) 
• getReqSMSDestlnfo 

protected Vector getReqSMSDestlnfo (Inf oServerElement element, UserAgent agent) 
ft getRequiredData 

public Vector getRequiredData (String destld, Inf oServerElement element, UserAgent agent, int 
elementType) 

Return existing Required Data associated with an existing element 
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• getRequirements 

public Vector getRequirements (String name, int elementType) 
Return Required information necessary for creating an element of this type 

• getSimpleDestination 

private SimpleUserDestination getSimpleDestination (String destination, StringBuffer errorMsg) 
Create a Simple user destination 

• getSMSDestination 

private SMSUserDestination getSMSDestination (String destination, Vector reqlnfo, StringBuffer 
errorMsg) 

Load elements descriptions from resource file into hashtables 

• getStyles 

protected Vector getStyles (String name, int elementType) 
Return Required Information necessary for creating an element of this type 

• getSubForm 

public String getSubForm (String name, Inf oServerElement element, UserAgent agent, int elementType) 
j»% Get form components necessary in creating the specifed element 
fli isVaiidHostName 

^protected boolean isVaiidHostName (String host) 

||1 Check to see if host name is valid. Return True if valid False if invalid. 

I jjPI loadElements 

Spublic void loadElements (String sourceElements , String destElements) 

s Load elements descriptions into hashtables, this method should only ever be called once by the loader so no need to synchronize, 
flj* rateReliability 

flfcrotected String rateReliability (String key) 

^ Relate reliability of Xml parsing key based on a scale of 1-10 were l=most reliable and 10=least reliable. The less tags in the key, the 
Q more reliable. 4 tags or less is a 1, and every tag after that adds 1 to the rating. For ex./ Clip.Htmi[0].Body[0].Table[0] is very reliable 
M and would be a 1, and Clip.Html[0].Body[0].Table[2].TR[l].TD[2] would be less reliable(but still reasonably reliable) and would be a 3 

• returnDbType 

protected Hashtable returnDbType (int elementType) 
Return correct hashtable dependent on elementType 

• validMin 

protected boolean validMin (String address) 

Look at the msgMIN field to ensure that it really contains a MIN. It is possible that it could actually contain alternate addressing info, 
which must be translated to a MIN address. 

H Class tcs.ain.infoserver.servlet ONServletResource 

public class QNServletResource 

This class is a singleton for a property resource bundle to be used by the Query Net Wizard. The resource bundle contains values that could 
potentially displayed to users. It also provides a direct, static method for safely getting String values without worrying about 
MIssingResourceExceptions ras; 2/29/99; modified by S. Levine on 9/9/99 

Attributes 

resourceBundle 
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Operations 

getBundle() 
getlnt(String) 
getString(String) 
initResourceBundleQ 



<i resourceBundle 

private static ResourceBundle resourceBundle = null 
The resource bundle we keep for use by the package. 



0 getBundle 

public static ResourceBundle getBundle () 

Return the single, static instance of the resource bundle for the SMPP Module 

• getlnt 

public static int getlnt (String key) 
D Pass through to the resourceBundle, except that we internally catch the MissingResourceException and report the error but return a " 
i'ft Return Int value. 

Jji getString 

public static String getString (String key) 

J! Pass through to the resourceBundle, except that we internally catch the MissingResourceException and report the error but return a " 
5fl initResourceBundle 

si private static void initResourceBundle () 
W Create the resource bundle 

pfl Class tcs.ainJnfoserver.seMet QNWebPazePrinter 

Q)ublic class QNWebPagePrinter 

^'"Extends: 

tcs.web.WebPagePrinter 

Constructors 

QNWebPagePrinter(tcs.web.WebPage) 



Operations 

printQ 



• QNWebPagePrinter 

public QNWebPagePrinter ( tcs . web . WebPage ) 



H print 

public void print ( ) 
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B Class tcs.ain/mfoserver.servletQNWebPagePrinter 

public class QNWebPagePrinter 

Extends: 

tcs.web.WebPagePrinter 

Base class for web page printing operations. Provides methods to print the header, banner, etc. Subclasses can provide distinct color / font 
/ banner schemes for individual projects or pages 

Constructors 

QNWebPagePrinter(WebPage) 

Operations 

print() 

» QNWebPagePrinter 

public QNWebPagePrinter (WebPage page) 

Construct the page printer object. This assings the owner and gets the output stream 

Print 

'^public void print () 

TZ public print method; what client calls to start the printing process. This calls the basic components of the page (header, banner, body, 
footer) 

WM Class tcs.ain. infoserver.servlet QueryNetResource 

£ class QueryNetResource 

jrfThis class is a singleton for a property resource bundle to be used by the Query Net Wizard. The resource bundle contains values that could 
llpotentially displayed to users. It also provides a direct, static method for safely getting String values without worrying about 
^fMlssingResourceExceptions ras; 2/29/99; modified by S. Levine on 9/9/99 

set 

^Attributes 

w l resourceBundle 

Operations 

getBundle() 

getString(String) 

initResourceBundie() 

resourceBundle 

private static ResourceBundle resourceBundle = null 
The resource bundle we keep for use by the package. 



^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ 

• getBundie 

public static ResourceBundle getBundie 0 

Return the single, static instance of the resource bundle for the SMPP Module 
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H getString 

public static String getString (String key) 

Pass through to the resourceBundle, except that we internally catch the MissingResourceException and report the error but return a T 

• initResourceBundle 

private static void initResourceBundle ( ) 
Create the resource bundle 



B Class tcs.ain.infoserver. servlet StatusForm 

public class StatusForm 
Extends: 

tcs.ain.infoserver.servlet.DataWorkerWizardForm 
Define the Data Sources that are desired. 

Attributes 

HtmlPage 
testld 

Constructors 

^ StatusForm(HttpServlet Request, IRemoteRepository, String) 

^Operations 

%| getDestinations() 

m getForm() 

il\ getTagTableO 

%l populateFormFromWorkerQ 

-fc populateWorkerFromFormO 




mmmamommmmmmm 



CP HtmlPage 

fl^rotected static StringBuffer HtmlPage 

IS? Stores Html Page associated with a form producing class 

Cll testld 

r protected String testld 

Id to be used for script testing only 



gg^§r Detail 
• StatusForm 

public StatusForm (HttpServletRequest request, IRemoteRepository access, String stepDesc) 
Constructor 



W. getDestinations 

protected String getDestinations ( ) 

Return destinations associated with dataworker in html tag IMPORTANT: 1.) ONLY FILTERS WILL HAVE CHILD LISTENERS 2.) CHILD 
LISTENERS CAN BE OTHER FILTERS OR DESTINATIONS 3.) CHILD LISTENERS WILL NOT HAVE SIBLINGS 4.) DESTINATIONS WILL NOT 
HAVE CHILD LISTENERS ex/ ChangeOniyFilter | SearchFilter | | | SMS Dest. Email Dest. Chat Dest 
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Wt getForm 

public String getForm () 

Return the appropriate form for adding new workers or selecting existing workers 

• getTagTabie 

protected Hashtable getTagTabie ( ) 

Create a table of tags and their values to be used in replacing tags found in static html pages. Used to add dynamic content to these 
pages. 

• populateFormFromWorker 

protected void populateFormFromWorker ( ) 

Populate the form fields with values from the DataWorker 

!§ popuIateWorkerFromForm 

public String popuIateWorkerFromForm ( ) 

Populate the DataWorker with data assigned to the form 

B Class tcs.ainJnfoserver.servlet.ViewServicesPaRe 

public class ViewServicesPage 
'^Extends: 

y*{ tcs. a i n . inf oserver. servlet. 1 nf oSvrPage 
^tributes 

U J Htm (Page 

4- 

l s Qonstructors 

S| ViewServicesPage(HttpServletRequest, HttpServietResponse, UserAgent) 
^Operations 

getBody() 
flf getDestinations(DataWorker) 
f|| GetPageld() 
Uil getTagTable() 

processFormData(HttpServletRequest) 
Q. showServiceListQ 



•f- HtmiPage 

protected static StringBuffer HtmiPage 

Stores Html Page associated with a form producing class 



■■■1 



ViewServicesPage 

public ViewServicesPage (HttpServletRequest request, HttpServietResponse response, UserAgent agent) 
Constructor calls super() and sets the title for this page 

ft getBody 

public String getBody () 

Return the page's body. For increased efficiency, this directly writes to the response output and does not actually return any data. 
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$ getDestinations 

protected String getDestinations (DataWorker worker) 

Return destinations associated with dataworker in htmt tag IMPORTANT: L) ONLY FILTERS .WILL I HAVE CHILD 

LISTENERS CAN BE OTHER FILTERS OR DESTINATIONS 3.) CHILD LISTENERS WILL NOT HAVE SIBLINGS 4.) DESTINATIONS WILL NOT 
HAVE CHILD LISTENERS ex/ ChangeOnlyFilter | SearchFilter | | I SMS Dest. Email Dest. Chat Dest 

d GetPageld 

public static int GetPageld 0 
9t getTagTable 

protected Hashtable getTagTable { ) 

Create a table of tags and their values to be used in replacing tags found in static html pages. Used to add dynamic content to these 
pages. 

• processFormData 

public void processFormData {HttpServlet Request request) 

Start and stop workers based on user input 
$ showServiceList 

protected String showServiceList {) 

Q Create a table and show a summary of each of the services (ie, Workers owned by the userAgent. The worker titles will also contain 
J i hyperlins for more information and editing choices 



KB Class tcs.ain.infoserver. SimpleUserDestination 

ill 

"^public class SimpleUserDestination 
^Extends: 

fir| tcs.ain.infoserver. UserDeliveryDestination 
s Just send the output to STDOUT. 

^Operations 

fU cleanUpQ 
J=H getSaveables() 

processData(DataEvent) 
M setSaveables(Object[]) 

fl> cleanUp 

public void cleanup ( ) 
Clean Up Data 

• getSaveables 

public Object [] getSaveables { ) 

Return an array of all objects that should be persistent, primitive datatypes must be converted to their Object equivalent. These objects 
will come back in the same order when setSaveables is called. 

• processData 

public void processData (DataEvent evt) 
I have new data; Send the data string to the screen 

Throws: 

InfoServerException 
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•> setSaveables 

public void setSaveables (Object [ 3 oa) 

receive an array of objects that have been saved, the order will correspond to that specified when getSaveables was called. Users should 
handle Null values in the array. 

fi Class fcs.a/njnfose/ver.s/mp/ewebXustom Ema/7SourceGeneratQr 

public class CustomEmailSourceGenerator 
This class is used to generated a customer Email Source 

Operations 

createEmailQueryEngine(String, String, String) 
isValidMailHost(String) 

• createEmailQueryEngine 

public NewEmailQueryEngine createEmailQueryEngine (String hostName, String userld, String password) 

Based on the parameters received from the request, attempt to create a NewEmailQueryEngine object. Throw an Exception with 
description of the problem if there is one. TO DO: DNS Validation, as with servlet, Remove Hard-Coded names 

Q Throws: 

,p InvalidParameterException 

Jfj java.net.UnknownHostException 

jffl isValidMailHost 

"^protected boolean isValidMailHost (String hostname) 
| 5 y Do the DNS MX lookup to determine if this host is valid or not 

Si 

%M Class tcs.ainjnfoservensimDlewebXustomWebSourc eFormGenerator 

H public class CustomWebSourceFormGenerator 

flfThis presents all of the Public Data Sources and provides relevant information for any UserAgents that reference the public sources 

R 

retributes 

fsB^t returnJsp 
SaveButtonld 

Constructors 

CustomWebSourceFormGenerator(String) 

Operations 

getFormForDataWorker(DataWorker) 
getFormHtml(Hashtable, String, String) 
getNewFormHtml(String, String) 
getPageParserQueryEngine(DataWorker) 
getPageParserQueryEngineFromForm(HttpServtetRequest) 

• returnJsp 

String returnJsp 



A SaveButtonld 

public static String SaveButtonld = "save" 
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Wt CustomWebSourceFormGenerator 

public CustomWebSourceFormGenerator (String returnJsp) 
Called from the JspBean when user wants forms representing workers 

• get Form ForDataWorker 

public String get FormForDataWorker (DataWorker worker) 

Show the data selection form, but based on the PageParserQE already contained by this worker 

Throws: 

Exception 

• getFormHtml 

protected String getFormHtml (Ha sht able currentSelectedl terns, String href, String startText) 
Generate the form for selecting data from the href, setup the field to checked if currentSelected Items contains the field already 

Throws: 

Exception 

% getNewFormHtml 

public String getNewFormHtml (String href, String startText) 

If! show a new form for selecting content startText can be null or 0 length if not relevant includes a 'saveform' submit button at the end. 



SI 



I Throws: 

W- Exception 

Ml getPageParserQueryEngine 

Jftatic PageParserQueryEngine getPageParserQueryEngine (DataWorker worker) 
fi\ Return a PageParserQueryEngine if associated with this data source, return null if none found 

Jsjl getPageParserQueryEngineFromForm 

public PageParserQueryEngine getPageParserQueryEngineFroniForm(HttpServletRequest request) 
Create and return a PageParserQueryEngine based on the form variables. 

Throws: 

Exception 

H Class tcs.ainJnfoseiver.simpleweb.CustomWebSourceFormGenerator 

public class CustomWebSourceFormGenerator 

Extends: 

java.lang.Object 

Attributes 

returnJsp 
SaveButtonld 

Constructors 

CustomWebSourceFormGenerator(java.lang.String) 

Operations 

getFormForDataWorker(tcs.ain.infoserver.DataWorker) 
getFormHtml(java.utii.Hashtable, java.lang.String, java.lang.String) 
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getNewFormHtml(java.lang.String, java.lang.String) 

getPageParserQueryEngine(tcs.ain.infoserver.DataWorker) 

getPageParserQueryEngineFromForm(javax.servlet.http.HttpServletRequest) 



• returnJsp 

java.lang.String returnJsp 



• SaveButtonld 

public static java.lang.String SaveButtonld 



ructorDotail 



■ ■ -Y:::; = i-E:- : = : ^ 



MB 



• CustomWebSourceFormGenerator 

public CustomWebSourceFormGenerator (java . lang . String) 




• getFormForDataWorker 

public java. lang. String getFormForDataWorker (tcs .ain. inf oserver .DataWorker) 

Nj| getFormHtml 

protected java.lang.String getFormHtml (java. util .Hasht able, java.lang.String, java.lang.String) 
4ij§ getNewFormHtml 

public java.lang.String getNewFormHtml (java . lang . String , java.lang.String) 

m 

!L|I getPageParserQueryEngine 

Cl 

^static tcs . ain. inf oserver . Page Pars erQuery Engine 
getPageParserQueryEngine (tcs .ain. inf oserver .DataWorker) 

2* getPageParserQueryEngineFromForm 

^public tcs .ain. inf oserver . PageParserQueryEngine 

-""get Page Par serQueryEngineFromForm ( j avax . servlet . http . HttpServlet Request ) 



B Class tcs.ain.infoserver.simpleweb. CustomWebSourceFormGenerator 

public class CustomWebSourceFormGenerator 

This presents all of the Public Data Sources and provides relevant information for any UserAgents that reference the public sources 

Attributes 

returnJsp 
SaveButtonld 

Constructors 

CustomWebSourceFormGenerator(String) 

Operations 

getFormForDataWorker(DataWorker) 
getFormHtml(Hashtabie, String, String) 
getN ew Form Htm l(String, String) 
getPageParserQueryEngine(DataWorker) 
getPageParserQueryEngineFromForm(HttpServletRequest) 
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9 returnJsp 

String returnJsp 

9t SaveButtonld 

public static String SaveButtonld = "save" 



• CustomWebSourceFormGenerator 

public CustomWebSourceFormGenerator (String returnJsp) 
Called from the JspBean when user wants forms representing workers 



• getFormForDataWorker 

public String getFormForDataWorker (Da taWorker worker) 

Show the data selection form, but based on the PageParserQE already contained by this worker This is useful when/if we want to edit an 
Q existing Web QueryEngine 



n&f Throws: 

Exception 

III getFormHtml 

protected String getFormHtml (Hash table currentSelectedl terns , String href, String startText) 

Generate the form for selecting data from the href, setup the field to checked if currentSelected Items contains the field already TO DO: It 
would be really great to sort entries by confidence level! 

p| Throws: 

Exception 

\ Jjfc- getNewFormHtml 

fgublic String getNewFormHtml (String href, String startText) 

H show a new form for selecting content startText can be null or 0 length if not relevant includes a 'saveform' submit button at the end. 

Throws: 

Exception 

• getPageParserQueryEngine 

static PageParserQueryEngine getPageParserQueryEngine (DataWorker worker) 
Return a PageParserQueryEngine if associated with this data source, return null if none found 

• getPageParserQueryEngineFromForm 

public PageParserQueryEngine getPageParserQueryEngineFromForm (HttpServletRequest request) 
Create and return a PageParserQueryEngine based on the form variables. 

Throws: 

Exception 



B Class tcs.ainjnfoserver.simpleweb.CustomWebSourceGenerator 

public class CustomWebSourceGenerator 

This presents all of the Public Data Sources and provides relevant information for any UserAgents that reference the public sources 
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Attributes 

returnJsp 
SaveButtonld 

Constructors 

CustomWebSourceGenerator(String) 

Operations 

getConfidenceicon(int) 
getFormForDataWorker(DataWorker, String) 
getFormHtmi(Hashtable t String, String, String) 
getNewFormHtml(String, String, String) 
getPageParserQueryEngine(DataWorker) 
getPageParserQueryEngineFromForm(HttpServletRequest) 
isValidLabel(String) 




$ returnJsp 

String returnJsp 



ft SaveButtonld 

public static String SaveButtonld = "save" 




Op CustomWebSourceGenerator 

public CustomWebSourceGenerator (String returnJsp) 
= " , Called from the JspBean when user wants forms representing workers 




f|$ getConfidencelcon 

protected String getConf idencelcon (int level) 

y Return a representation of the confidence, based on the number. 

Mi getFormForDataWorker 

public String getFormForDataWorker (Da taWorker worker, String tableHeader) 

Show the data selection form, but based on the PageParserQE already contained by this worker This is usefu) when/if we want to edit an 
existing Web QueryEngine 

Throws: 

Exception 



• getFormHtml 

protected String getFormHtml (Hasht able currentSelectedltems, String href, String startText, String 
tableHeader) 

Generate the form for selecting data from the href, setup the field to checked if currentSelectedltems contains the field already throw an 
exception if the site can not be accessed TO DO: It would be really great to sort entries by confidence level! 

Throws: 

Exception 

• getNewFormHtml 

public String getNewFormHtml (String href, String startText, String tableHeader) 

show a new form for selecting content startText can be null or 0 length if not relevant includes a 'saveform' submit button at the end. 
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Throws: 

Exception 

# getPageParserQueryEngine 

protected PageParserQueryEngine getPageParserQueryEngine (DataWorker worker) 
Return a PageParserQueryEngine if associated with this data source, return null if none found 

• getPageParserQueryEngineFromForm 

public PageParserQueryEngine get Page Par serQueryEngineFromForm (HttpServletRequest request) 
Create and return a PageParserQueryEngine based on the form variables. 

Throws: 

InvalidParameterException 
java.net. UnknownHostException 

9 isValidLabel 

protected boolean isValidLabel (String label) 
Does this consist of a-z or A-Z? 

B Class tcs.ainJnfoserver.simplewebJnvalidParameterException 

Pljpublic class InvalidParameterException 

tffextends: 

java.lang.Exception 

^iThis can be thrown whenever a JSP passes parameters to an object and the parameters are missing, invalid, etc. 

Ill- 

^Constructors 

y ; | InvalidParameterException(String) 
FijH InvalidParameterException 

H|>ublic InvalidParameterException (String s) 

yM Class tcs.ain.infoserver.simpleweb.JspBean 

public class JspBean 

This provides some methods to simplify access to QNet and also return some dynamic HTML content. 

Attributes 

infoServerAccess 

jdbcConn 

UserAgentld 

UserDatald 

userDb 

Constructors 

JspBean() 

Operations 

createEmailQueryEngine(HttpServletRequest) 
getAgentWorkerEditForms(HttpSession, String) 
getCreatePubl icWorkerForm(String, String) 
getUserAgent(HttpSession) 
getUserData(HttpSession) 
getWorkerCount(HttpSession) 
isSystemAvai!able() 
isValidSession(HttpSession) 
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login(String, String, HttpSession) 

logout(HttpSession) 

main(String[]) 

makeDbConnectionO 

makeRMIConnection() 

processCustomWorkerCreateRequest(HttpSession, HttpServietRequest, QueryEngine) 
processPublicWorkerCreateRequest(HttpSession, HttpServietRequest) 
processWorkerChangeRequest(HttpSession, HttpServietRequest) 
vaiidateDbConnection() 
vaiidateRMIConnectionO 



• infoServerAccess 

protected IRemoteRepository infoServerAccess = null 

• jdbcConn 

protected Connection jdbcConn - null 

• UserAgentld 

static final String UserAgentld = "UserAgent" 



1 UserDatald 

Gktatic final String UserDatald = "UserData" 

si 

userDb 

protected SMSAppDB userDb = null 



§ 

= & JspBean 

[public JspBean () 

m 



createEmailQueryEngine 

public NewEmailQueryEngine createEmailQueryEngine (HttpServietRequest request) 

Based on the parameters received from the request, attempt to create a NewEmai (Query Engine object. Throw an Exception with 
description of the problem if there is one. TO DO: DNS Validation, as with servlet, Remove Hard-Coded names 

Throws: 

Exception 

• getAgentWorkerEditForms 

public String [] getAgentWorkerEditForms (HttpSession sess, String actionAddr) 

Return array of HTML forms that presents ail of the data workers for the user. The forms are populated with values assigned to the 
worker, and allow the values to be updated. Also includes forms for disabling, enabling, and remove public agents, returns null if none 
found 

Parameter doc: 

session,response, and the address of the 'page' that processes the form 



• getCreatePublicWorkerForm 

public String getCreatePublicWorkerForm (String callbackPage, String buttonLabel) 
Get the Form that is used to create a new Public Data Worker 
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• getUserAgent 

public UserAgent getUserAgent (HttpSession session) 
Get the UserAgent object for this session could return null if not defined 

• getUserData 

public UserData getUserData {HttpSession session) 
Get the UserData object for this session could return null if not defined 

• getWorkerCount 

public int getWorkerCount (HttpSession session) 
Return how many worker the user in this session has 

• isSystemAvailable 

public boolean isSystemAvailable ( ) 

Validate that the RM1 and DB Connections are OK. Return true if all is OK. 

• isValidSession 

public boolean isValidSession (HttpSession sess) 

Return true if this is a valid session already; i.e., has a UserAgent and UserData for the logged in user 

? il login 

public boolean login (String userName, String password, HttpSession sess) 

"si 

111 Is this a valid username & password? If so, a session object is created and the UserAgent and UserData are loaded into the session If the 

HI session already exists for userName/ password, then return true; Note that if internal connection (RMI, DB) are bad, then this returns false 

"Zl with no indication. 

\M logout 

public void logout (HttpSession sess) 
rn clear out the user session. 

IM main 

public static void main (String [3 args) 

Jjl makeDbConnection 

protected void makeDbConnection ( ) 

Make sure jdbcConn is valid. If not, report the error to out and return false 

Throws: 

SQLException 

makeRMIConnection 

protected void makeRMIConnection ( ) 

Connect the remote object to the server if necessary 

Throws: 

Exception 

$ processCustomWorkerCreateRequest 

public void processCustomWorkerCreateRequest (HttpSession sess, HttpServletRequest request, 
Que ryEng ine qe ) 

Process the request to create a worker from the specified data source TO DO: Have this created based on admin-assignable default values 
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• processPubiicWorkerCreateRequest 

public void process Publi cWorker Cr e ateRequest (HttpSessi on sess, HttpServletRequest request) 

Process the request to create a worker from public data source This actually just gets the public QE and then calls 
processCustomWorkerCreateRequest 

• processWorkerChangeRequest 

public boolean processWorkerChangeRequest (HttpSess ion sess, HttpServletRequest request) 

Process the worker change request that would have originated from a form generated by getAgentWorkerEditForms() return the 
of the operation 

• validateDbConnection 

protected void validateDbConnection ( ) 

Make sure con is valid. If not, report the error to out and throw the exception TO DO: RECONNECT ON FAILURE 

Throws: 

SQLException 

• validateRMIConnection 

protected boolean validateRMIConnection ( } 

make connection if necessary; test the connection; if failed, try to to remake the connection return true if good connection 

jjH Class tcs.ain.infoserver.simpleweb.JspBean 

public class JspBean 

^;¥his provides some methods to simplify access to QNet and also return some dynamic HTML content. 

^Attributes 

¥j ChangeWorkerButtonld 

III CreatePublicWorkerButtonld 

a dbCheckSql 

DeleteWorkerButtonld 
Jj* infoServerAccess 
f|| jdbcConn 
ffji UserAgentld 

UserDatald 

userDb 

^Constructors 

JspBeanQ 

Operations 

getAgentWorkerEditForms(HttpSession, String) 

getCreatePub!icWorkerForm(String, String) 

getUserAgent(HttpSession) 

getUserData(HttpSession) 

getWorkerCount(HttpSession) 

isSystemAvaiiable() 

isValidSession(HttpSession) 

login(String, String, HttpSession) 

logout(HttpSession) 

main(String[]) 

makeDbConnectionO 

makeRMiConnectionO 

processCustomWorkerCreateRequest(HttpSession, HttpServletRequest, QueryEngme) 

processPubficWorkerCreateRequest(HttpSession, HttpServletRequest) 

processWorkerChangeRequest(HttpSession, HttpServletRequest) 

ShouldWorkerQueryAlways(String) 

validateDbConnection() 

validateRMiConnectionQ 
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9 ChangeWorkerButtonld 

public static final String ChangeWorkerButtonld = "change" 
9 CreatePublicWorkerButtonld 

public static final String CreatePublicWorkerButtonld « "create" 

9 dbCheckSql 

protected String dbCheckSql = "select 'x 1 from dual" 

© DeleteWorkerButtonld 

public static final String DeleteWorkerButtonld = "delete" 

• infoServer Access 

protected IRemoteRepository inf oServerAccess = null 

9 jdbcConn 

protected Connection jdbcConn = null 

?st P UserAgentId 

yjstatic final String UserAgentId = "UserAgent" 

;vp UserDatald 

fjfstatic final String UserDatald « "UserData" 

sis 

(ip userDb 

0|>rotected SMSAppDB userDb = null 



^^^^^^^^^^^^^^^^^^ 



Ipt JspBean 

^public JspBean {) 



9 getAgentWorkerEditForms 

public String!] getAgentWorkerEditForms (HttpSes s ion sess, String actionAddr) 

Return array of HTML forms that presents all of the data workers for the user. The forms are populated with values assigned to the 
worker, and allow the values to be updated. Also includes forms for disabling, enabling, and remove public agents, returns null if none 
found 

Parameter doc: 

session, response, and the address of the 'page' that processes the form 
91 getCreatePublicWorkerForm 

public String getCreatePublicWorkerForm (String callbackPage , String buttonLabel) 

Get the drop-down public list Form that is used to create a new Public Data Worker this is performed in here because of the complexity of 
the queries 

9 getUserAgent 

protected UserAgent getUserAgent (HttpSession session) 

Get the UserAgent object for this session couid return null if not defined protected for now; if JSP Really needs access, we can open it up 
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• getUserData 

public UserData getUserData (HttpSession session) 
Get the UserData object for this session could return null if not defined 

• getWorkerCount 

public int getWorkerCount (HttpSession session) 
Return how many worker the user in this session has 

isSystemAvailable 

public boolean isSystemAvailable ( ) 

Validate that the RMI and DB Connections are OK. Return true if all is OK. 

• isValidSession 

public boolean isValidSession (HttpSession sess) 

Return true if this is a valid session already; i.e., has a UserAgent and UserData for the logged in user 

• login 

public boolean login (String userName, String password, HttpSession sess) 

Is this a valid username & password? if so, a session object is created and the UserAgent and UserData are loaded into the session If the 
session already exists for userName/password, then return true; Note that if internal connection (RMI, DB) are bad, then this returns false 
Q with no indication. 

C^- logout 

lipublic void logout (HttpSession sess) 
\r ' clear out the user session. 

yjd- main 

rt|>ublic static void main (String [] args) 

CP makeDbConnection 

Hf>rotected void makeDbConnection ( ) 

^1 Make sure jdbcConn is valid. If not report the error to out and return false 

P! Throws: 

jU SQLException 

• makeRMIConnection 

protected void makeRMIConnection ( ) 

Connect the remote object to the server if necessary 

Throws: 

Exception 

• processCustomWorkerCreateRequest 

public void processCustomWorkerCreateRequest (HttpSession sess, HttpServletRequest request, 
Query Engine qe) 

Process the request to create a worker from the specified data source TO DO: Have this created based on admin-assignable default values 

• processPublicWorkerCreateRequest 

public void processPublicWorkerCreateRequest (HttpSession sess, HttpServletRequest request) 

Process the request to create a worker from public data source This actually just gets the public QE and then calls 
processCustomWorkerCreateRequest 



Page 189 of 326 

•f processWorkerChangeRequest 

public boolean processWorkerChangeRequest (HttpSession sess, HttpServletRequest request) 

Process the worker change request that would have originated from a form generated by getAgentWorkerEditForms() return the 
of the operation 

• ShouldWorkerQueryAlways 

public static boolean ShouldWorkerQueryAlways (String qeld) 

Some QueryEngines should be always queried; this determines if ID is one of them, as defined by queryAlways in the prop file 

ft validateDbConnection 

protected void validateDbConnection ( ) 

Make sure con is valid. If not, report the error to out and throw the exception 

Throws: 

SQLException 

<* validateRMIConnection 

protected boolean validateRMIConnection { } 

make connection if necessary; test the connection; if failed, try to to remake the connection return true if good connection 

3B Class tcs.ain.infoserver.simpleweb.JspBean 

^public c i ass j S pBean 

gjThis provides some methods to simplify access to QNet and also return some dynamic HTML content 

^Attributes 

1 1; infoServerAccess 

jdbcConn 
M UserAgentld 
... r UserDatald 
■-■I userDb 

^Constructors 

II JspBean() 

.33.5; 

^Operations 

^ createEmailQueryEngine(HttpServletRequest) 
getAgentWorkerEditForms(HttpSession, String) 
getCreatePublicWorkerForm(String) 
getUserAgent(HttpSession) 
getUserData(HttpSession) 
getWorkerCount(HttpSession) 
isSystemAvailable() 
isVaiidSession(HttpSession) 
login(String, String, HttpSession) 
logout(HttpSession) 
main(String[]) 
makeDbConnection() 
makeRMIConnection() 

processCustomWorkerCreateRequest(HttpSession, HttpServletRequest, QueryEngine) 
processPublicWorkerCreateRequest(HttpSession, HttpServletRequest) 
processWorkerChangeRequest(HttpSession, HttpServletRequest) 
validateDbConnection() 
validateRMIConnection() 

• infoServerAccess 

protected IRemoteRepository infoServerAccess = null 
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• jdbcConn 

protected Connection jdbcConn = null 

• UserAgentld 

static final String UserAgentld = "UserAgent " 

• UserDatald 

static final String UserDatald = "UserData" 

• userDb 

protected SMSAppDB userDb = null 



r Detail 



• JspBean 

public JspBean () 




r# createEmailQueryEngine 

il&uMic NewEmailQueryEngine createEmailQueryEngine (HttpServlet Request request) 

Based on the parameters received from the request, attempt to create a NewEmailQueryEngine object. Throw an Exception with 
111 description of the problem if there is one. TO DO: DNS Validation, as with servlet 

w a l Throws: 

Exception 

WJi getAgentWorkerEditForms 

^public String [] getAgentWorkerEditForms (HttpSession sess, String actionAddr) 

flJ Return arra Y of HTML forms that presents all of the data workers for the user. The forms are populated with values assigned to the 
n § worker, and allow the values to be updated. Also includes forms for disabling, enabling, and remove public agents returns null if none 
? »• found 

Si. Parameter doc: 

y' session, response, and the address of the 'page* that processes the form 

• getCreatePublicWorkerForm 

public String getCreatePublicWorkerForm (String callbackPage) 
Get the Form that is used to create a new Public Data Worker 

• getUserAgent 

public UserAgent getUserAgent (HttpSession session) 
Get the UserAgent object for this session could return null if not defined 

• getUserData 

public UserData getUserData (HttpSession session} 
Get the UserData object for this session could return null if not defined 

• getWorkerCount 

public int getWorkerCount (HttpSession session) 
Return how many worker the user in this session has 
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SI isSystemAvailable 

public boolean isSystemAvailable ( ) 

Validate that the RMI and DB Connections are OK. Return true if alt is OK. 

• isValidSession 

public boolean isValidSession {HttpSession sess) 

Return true if this is a valid session already; i.e., has a UserAgent and UserData for the logged in user 

• login 

public boolean login {String userName, String password, HttpSession sess) 

Is this a valid username & password? If so, a session object is created and the UserAgent and UserData are loaded into the session If the 
session already exists for userName/password, then return true; Note that if internal connection (RMI, DB) are bad, then this returns false 
with no indication. 

•f logout 

public void logout (HttpSession sess) 
clear out the user session. 

9 main 

public static void main (String [] args) 

y[|l makeDbConnection 

%jbrotected void makeDbConnection ( ) 

m 

^ Make sure jdbcConn is valid. If not, report the error to out and return false 

p Throws: 

l*= SQLException 

aL 

"■■m makeRMIConnection 

^protected void makeRMIConnection ( ) 

III Connect the remote object to the server if necessary 

Throws: 

Exception 

^Sl processCustomWorkerCreateRequest 

public void processCustomWorkerCreateRequest (HttpSession sess, HttpServletRequest request, 
GueryEngine qe) 

Process the request to create a worker from the specified data source TO DO: Have this created based on admin-assignable default values 

• processPublicWorkerCreateRequest 

public void processPublicWorkerCreateRequest (HttpSession sess, HttpServletRequest request) 

Process the request to create a worker from public data source This actually just gets the public QE and then calls 
processCustomWorkerCreateRequest 

• processWorkerChangeRequest 

public boolean processWorkerChangeRequest (HttpSession sess, HttpServletRequest request) 

Process the worker change request that would have originated from a form generated by getAgentWorkerEditForms() return the success 
of the operation 

• validateDbConnection 

protected void validateDbConnection ( ) 

Make sure con is valid. If not, report the error to out and throw the exception TO DO: RECONNECT ON FAILURE 
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Throws: 

SQLException 

• validateRMIConnection 

protected void val ida teRMI Connect ion () 

make connection if necessary; test the connection; if failed, try to to remake the connection return true if good connection 

B Class tcs.ainJnfoserver.simpleweb.PublicAgentListGenerator 

public class PublicAgentListGenerator 
Extends: 

java.lang.Object 

Attributes 

agentWorkers 
infoServerAccess 
userAgent 
userData 

Constructors 

PublicAgentListGenerator(tcs.ain.infoserver.UserAgent, tcs.ain.appdata.UserData, tcs.ain.infoserver.access.IRemoteRepository) 
^Qperations 
*%l getForms() 

^Jpl agentWorkers 

I protected tcs .ain. inf oserver .DataWorker [] agentWorkers 
Hit infoServerAccess 

protected tcs . ain . inf oserver . access . IRemoteRepository infoServerAccess 

j|fl userAgent 

fjrotected tcs .ain. inf oserver .UserAgent userAgent 

jjijl userData 
protected tcs.ain.appdata.UserData userData 

• PublicAgentListGenerator 

public PublicAgentListGenerator (tcs. ain. inf oserver. UserAgent, tcs.ain.appdata.UserData, 
tcs . ain . inf oserver . access . IRemoteRepository} 

• getForms 

public java.lang.StringE] getForms () 

^ Class tcs.ainJnfo server.simpleweb.PublicAsentListte 

public class PublicAgentListGenerator 
Extends: 
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javaJang.Object 

Attributes 

agentWorkers 
infoServerAccess 
userAgertt 
userData 

Constructors 

PublicAgentListGenerator(tcs.ain.infoserver.UserAgent f tcs.ain.appdata. UserData, tcs.ain.infoserver.access.iRemoteRepository) 
Operations 

getFormsQ 



• agentWorkers 

protected tcs .ain. inf oserver .DataWorker [] agentWorkers 

• infoServerAccess 

protected tcs . ain . inf oserver . access . IRemoteRepository infoServerAccess 

• userAgent 

protected tcs .ain. inf oserver .UserAgent userAgent 



h userData 

^protected tcs. ain. appdata. UserData userData 



£I| 



@ 3 PublicAgentListGenerator 

gf> ubl ic Publ icAgentListGenerator ( tcs . ain . inf oserver . UserAgent , tcs . ain . appdata . UserData , 
flics . ain . inf oserver . access . IRemoteRepository) 



^^^^^^^^^^^^^^ 



(I getForms 

public java.lang.String[] getForms () 



B Class tcs.ain.infoserver.simpleweb. PublicAgentListGenerator 



public class PublicAgentListGenerator 

Extends: 

java. fang. Object 

Attributes 

agentWorkers 
infoServerAccess 
userAgent 
userData 

Constructors 

PublicAgentListGenerator(tcs.ain. inf oserver. UserAgent, tcs.ain.appdata.UserData, tcs.ain. inf oserver.access. IRemoteRepository) 
Operations 

getFormsQ 



Page 194 of 326 




• agentWorkers 

protected tcs . ain . inf oserver .DataWorker [] agentWorkers 

• infoServerAccess 

protected tcs . ain . inf oserver . access . IRemoteRepository infoServerAccess 

• userAgent 

protected tcs .ain. inf oserver .UserAgent userAgent 

• userData 

protected tcs. ain. appdata .UserData userData 




• PublicAgentListGenerator 

publ ic PublicAgentListGenerator ( tcs . ain . inf oserver . UserAgent , tcs . ain . appdata . UserData , 
tcs . ain . inf oserver . access . IRemoteRepository) 



7 # getForms 

I! 

public java.lang.String [] getForms {) 



WB Class tcs.ain. infoserver.simpleweb. UserWorkFormGenerator 

public class UserWorkFormGenerator 

Cf his P resents ali of the Public Data Sources and provides relevant information for any UserAgents that reference the public sources TO DO* 
fi pemove hard-coded English in the form use more constants for field ids 

"^Attributes 

O 

agentWorkers 
M infoServerAccess 
M IsRunningFId 

userAgent 

userData 

WorkerFId 



Constructors 

UserWorkFormGenerator(UserAgent, UserData, IRemoteRepository) 
Operations 

DoesSourceHaveEmaiiListener(IDataEventSource) 

DoesSourceHaveSmsListener(IDataEventSource) 

getChangeOnlyField(DataWorker) 

getDestinationfields(DataWorker) 

getForms(String) 

getlsRunningField(DataWorker) 

getTimerFields(DataWorker) 




d agentWorkers 

protected DataWorker [] agentWorkers = null 



• infoServerAccess 
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protected IRemoteRepository inf oServerAccess = null 

• IsRunningFId 

public static final String IsRunningFId = "isrunning" 

• userAgent 

protected UserAgent userAgent 

• userData 

protected UserData userData 

• WorkerFId 

public static final String WorkerFId = "workerid" 

• UserWorkFormGenerator 

public UserWorkFormGenerator (UserAgent ua, UserData ud, IRemoteRepository ir) 
Called from the JspBean when user wants forms representing workers 

if-, ;| 

^jpf DoesSourceHaveEmailListener 

jprotected static boolean DoesSourceHaveEmailListener ( IDataEventSource source) 

|; Return whether this IDataEventSource has a listener of this class type (Email) Enumerates over the various listeners- recursively calls 
j| itself for Filter types ' J 

DoesSourceHaveSmsListener 

^static boolean DoesSourceHaveSmsListener (IDataEventSource source) 

If Return whether this IDataEventSource has a listener of this class type (SMS) Enumerates over the various listeners; recursively calls itself 
"II for Filter types There must be a more efficient way to do this 

fjfc getChangeOnlyField 

sis? 

protected StringBuffer getChangeOnlyField (DataWorker worker) 
return the ChangeOnly label and checkbox 

• getDestinationfields 

protected StringBuffer getDestinationfields (DataWorker worker) 
Return fields for whether SMS and/or Email Destinations are to be used 

• getForms 

public String [] getForms {String actionAddr) 

Return an array of Strings, each of which contains a form for viewing and editing the worker agents. An array is returned because the 
calling JSP page might want to put each form in a table cell, or something similar for formatting purposes, receive page address that will 
process the form action KS Wl " 

• getlsRunningField 

protected StringBuffer getlsRunningField (DataWorker worker) 
Get fields for whether agent is running 

• getTimerFields 

protected StringBuffer getTimerFields (DataWorker worker) 
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Return the timer selection fields for the queryengine Min of hour, Hour of day, DOW, DOM 



H Class tcs.ainJnfoseiver.simpleweb.UserWorkFormGenerator 

public class UserWorkFormGenerator 

This presents all of the Public Data Sources and provides relevant information for any UserAgents that reference the publ' 

Attributes 

agentWorkers 

EveryldLbi 

infoServerAccess 

IsRunningFId 

userAgent 

userData 

WorkerFId 

Constructors 

UserWorkFormGenerator(UserAgent ( UserData, IRemoteRepository) 

Operations 

DoesSou rceH aveEma i i Li stener( I Data EventSou rce) 

DoesSourceHaveSmsListener(IDataEventSource) 

getChangeOnlyField(DataWorker) 

getDestinationfields(DataWorker) 
P% getForms(String) 

getisRunningField(DataWorker) 
*U getTimerFields(DataWorker) 

agentWorkers 

Ujjprotected DataWorker[] agentWorkers = null 

MT EveryldLbi 

j|>ublic static String EveryldLbi = "Every" 

III 

^SSI infoServerAccess 

^'protected IRemoteRepository infoServerAccess = null 
F * IsRunningFId 

public static final String IsRunningFId = "isrunning" 

• userAgent 

protected UserAgent userAgent 

• userData 

protected UserData userData 
9t WorkerFId 

public static final String WorkerFId = "workerid" 

ft UserWorkFormGenerator 

public UserWorkFormGenerator (UserAgent ua, UserData ud, IRemoteRepository ir) 
Called from the JspBean when user wants forms representing workers 
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• DoesSourceHaveEmailListener 

protected static boolean DoesSourceHaveEmailListener (IDataEventSource source) 

Return whether this IDataEventSource has a listener of this class type (Email) Enumerates over the various listeners; recursively calls 
itself for Filter types 

• DoesSourceHaveSmsListener 

static boolean DoesSourceHaveSmsListener (IDataEventSource source) 

Return whether this IDataEventSource has a listener of this class type (SMS) Enumerates over the various listeners; recursively calls itself 
for Filter types There must be a more efficient way to do this 

© getChangeOnlyField 

protected StringBuffer getChangeOnlyField (DataWorker worker) 
return the ChangeOnty label and checkbox 

& getDestinationfields 

protected StringBuffer getDestinationfields (DataWorker worker) 
Return fields for whether SMS and/or Email Destinations are to be used 

f |l getForms 

public String [] getForms (String actionAddr) 

Vkf- 

M Return an array of Strings, each of which contains a form for viewing and editing the worker agents. An array is returned because the 

ff| calling JSP page might want to put each form in a table cell, or something similar for formatting purposes, receive page address that will 

fs| process the form action 

;A getlsRunningField 

protected StringBuffer getlsRunningField (DataWorker worker) 
s; Get fields for whether agent is running 

^jjjl getTimerFields 

^protected StringBuffer getTimerFields (DataWorker worker) 

£| Return the timer selection fields for the queryengine Min of hour, Hour of day, DOW, DOM 

f ~B Class tcs.ainJnfoseiver.simpleweb.UserWorkFormGenerator 

public class UserWorkFormGenerator 

This presents all of the Public Data Sources and provides relevant information for any UserAgents that reference the public sources 



Attributes 

agentWorkers 

EveryldLbl 

infoServerAccess 

IsRunningFId 

userAgent 

userData 

WorkerFId 



Constructors 

UserWorkFormGenerator(UserAgent, UserData, IRemoteRepository) 

Operations 

DoesSourceHaveEmaill_istener(!DataEventSource) 

DoesSourceHaveSmsListener(iDataEventSource) 

getChangeOniyFieid(DataWorker) 

getDestinationfields(DataWorker) 

getForms(String) 
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getlsRunningField(DataWorker) 
getTimerFieids(DataWorker) 




• agentWorkers 

protected DataWorker[] agentWorkers = null 

• EveryldLbl 

public static String EveryldLbl = "Every" 

• infoServerAccess 

protected IRemoteRepository infoServerAccess = null 

Wt IsRunningFId 

public static final String IsRunningFId = "isrunning" 

9t userAgent 

protected UserAgent userAgent 

• userData 

^protected UserData userData 

WorkerFId 

Hi 

Hlpublic static final String WorkerFId = "workerid" 




s 9: UserWorkFormGenerator 

^Jpublic UserWorkFormGenerator (UserAgent ua, UserData ud, IRemoteRepository ir) 
j^f Called from the JspBean when user wants forms representing workers 




9 DoesSourceHaveEmailListener 

protected static boolean DoesSourceHaveEmailListener (IDataEvent Source source) 

Return whether this IDataEventSource has a listener of this class type (Email) Enumerates over the various listeners; recursively calls 
itself for Filter types 

• DoesSourceHaveSmsListener 

static boolean DoesSourceHaveSmsListener ( IDataEventSource source) 

Return whether this IDataEventSource has a listener of this class type (SMS) Enumerates over the various listeners; recursively calls itself 
for Filter types There must be a more efficient way to do this 

• getChangeOnlyField 4 

protected StringBuffer getChangeOnlyField (DataWorker worker) 

return the ChangeOnly label and checkbox 

• getDestinationfields 

protected StringBuffer getDestinationfields (DataWorker worker) 
Return fields for whether SMS and/or Email Destinations are to be used 
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• getForms 

public String [] getForms (String actionAddr) 

Return an array of Strings, each of which contains a form for viewing and editing the worker agents. An array is returned because the 
calling JSP page might want to put each form in a table cell, or something similar for formatting purposes, receive page address that will 
process the form action 

ft getlsRunningField 

protected StringBuffer getlsRunningField (DataWorker worker) 
Get fields for whether agent is running 

ft getTimerFields 

protected StringBuffer getTimerFields (DataWorker worker) 

Return the timer selection fields for the queryengine Min of hour, Hour of day, DOW, DOM 

B Class tcs.ainJnfoseiver.simDleweb.UserW orkFormProcessor 

public class UserWorkFormProcessor 

This guy applies change requests for a worker against the useragent, which is obtained by querying the session 
Attributes 

G] dataWorker 

infoServerAccess 
i^s request 

userAgent 
111 userData 

Constructors 

UserWorkFormProcessor(UserAgent, UserData, IRemoteRepository, HttpServietRequest) 
B&perations 

«f addEmailSupport(IDataSource, IDataEventSource) 

p| addSmsSupport(IDataSource, IDataEventSource) 

J? applyChangeOnlyO 

lH applyDestinationFields() 

f|| applylsRunningO 

f*i appIyTimerFieldsO 

getWorkerChangeOnlyFiiter() 
^ processFormO 

N removeEmailSupport(IDataEventSource) 
removeSmsSupport(IDataEventSource) 

ft dataWorker 

protected DataWorker dataWorker = null 

ft infoServerAccess 

protected IRemoteRepository infoServerAccess = null 
ft request 

HttpServietRequest request = null 
ft userAgent 

protected UserAgent userAgent = null 

ft userData 

protected UserData userData = null 
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B UserWorkFormProcessor 

public UserWorkFormProcessor (UserAgent ua, UserData ud, IRemoteRepository ir, HttpServletRequest 
request) 

Called from the JspBean when we need to apply the results of having clicked on a form generated bby the UserWorkFormGenerator 

• addEmailSupport 

protected void addEmailSupport (IDataSource dataSource, IDataEventSource evtSource) 
add Email listener to this source TO DO: Pull Email constants from property file 

SI addSmsSupport 

protected void addSmsSupport (IDataSource dataSource, IDataEventSource evtSource) 
add Email listener to this source TO DO: Pull SMS constants from property file 

applyChangeOnly 

protected void applyChangeOnly ( ) 

p| Add or Remote a ChangeOnlyFilter, as directed by the checkbox. 

ill Throws: 
%l Exception 

iifl applyDestinationFields 

^protected void applyDestinationFields () 

2! Apply the request to add/ remove Destination TO DO: Make sure that what's happening with applyChangeOnly does not strangely affect 
^ this and vice-versa 

CJi applylsRunning 

lljprotected void applylsRunning ( ) 

H ■ Check and apply the isRunning field 

f;i Throws: 

Exception 

• applyTimerFields 

protected void applyTimerFields ( ) 

apply the timer fields; taking into special consideration the 'combined' time possibilities 

Throws: 

Exception 

• getWorkerChangeOnlyFilter 

protected ChangeOnlyFilter getWorkerChangeOnlyFilter ( ) 

Return a ChangeOnlyFilter that may be assigned to the dataWorker. If none is assigned, return null 

• processForm 

public boolean processForm( ) 

Check each of the possible fields and then save the agent return false if the form could not be processed; Note: We could also throw an 
exception to give more detail; 

• removeEmailSupport 

protected void removeEmailSupport ( IDataEventSource source) 
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Remove EmaiiDestination from the DataEventSource 
ft removeSmsSupport 

protected void removeSmsSupport (IDataEvent Source source) 
Remove SmsDestination from the DataEventSource 

B Class tcs.ain/mfos^rver.simpleweb.UserWo rkFormProcessor 

public class UserWorkFormProcessor 

This guy applies change requests for a worker against the useragent, which is obtained by querying the session 

Attributes 

dataWorker 
infoServer Access 
request 
userAgent 
userData 

Constructors 

UserWorkFormProcessor(UserAgent t UserData, IRemoteRepository, HttpServietRequest) 

Operations 

CI addEmailSupport(IDataSource, I DataEventSource) 
J? jj addSmsSupport(iDataSource t I DataEventSource) 
f h applyChangeOnlyO 

*f applyDestinationFields() 
Hi applyisRunningO 
Lfl applyTimerFieidsO 

ji" getWorkerChangeOnlyFilter() 
?l process Form() 

Ul removeEmailSupport(IDataEventSource) 
fit removeSmsSupport(iDataEventSource) 



ffii dataWorker 

Pbrotected DataWorker dataWorker = null 

infoServerAccess 

protected IRemoteRepository infoServerAccess = null 

ft request 

HttpServietRequest request = null 

ft userAgent 

protected UserAgent userAgent = null 

ft userData 

protected UserData userData = null 



• UserWorkFormProcessor 

public UserWorkFormProcessor {UserAgent ua, UserData ud, IRemoteRepository ir, HttpServietRequest 
request) 

Called from the JspBean when we need to apply the results of having clicked on a form generated bby the UserWorkFormGenerator 
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& addEmailSupport 

protected void addEmailSupport (IDataSource dataSource, IDataEventSource evtSource) 
add Email listener to this source TO DO: Pull Email constants from property file 

$1 addSmsSupport 

protected void addSmsSupport ( IDataSource dataSource, IDataEventSource evtSource) 
add Email listener to this source TO DO: Pull SMS constants from property file 

• applyChangeOnly 

protected void applyChangeOnly { ) 

Add or Remote a ChangeOnlyFilter, as directed by the checkbox. 

Throws: 

Exception 

• applyDestinationFields 

protected void applyDestinationFields ( ) 

Apply the request to add/remove Destination TO DO: Make sure that what's happening with applyChangeOnly does not strangely affect 
pi this and vice-versa 

fHSl applylsRunning 

^protected void applylsRunning ( ) 
l|! Check and apply the isRunning field 

■5 s ¥ 

y\ Throws: 

!£f Exception 

? II appIyTimerFields 

^protected void appIyTimerFields ( ) 

n\ apply the timer fields; taking into special consideration the 'combined' time possibilities 

C| Throws: 

Q Exception 

• getWorkerChangeOnlyFilter 

protected ChangeOnlyFilter getWorkerChangeOnlyFilter { ) 

Return a ChangeOnlyFilter that may be assigned to the dataWorker. If none is assigned, return null 

& processForm 

public boolean processForm ( ) 

Check each of the possible fields and then save the agent return false if the form could not be processed; Note: We could also throw an 
exception to give more detail; 

• removeEmailSupport 

protected void removeEmailSupport (IDataEventSource source) 
Remove Email Destination from the DataEventSource 

• removeSmsSupport 

protected void removeSmsSupport {IDataEventSource source) 
Remove SmsDestination from the DataEventSource 
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B Class tcs.ain/infoseiver.simpleweb.UserWorkFormProcessor 

public class UserWorkFormProcessor 

This guy applies change requests for a worker against the useragent, which is obtained by querying the session 

Attributes 

dataWorker 

infoServerAccess 

request 

userAgent 

userData 

Constructors 

UserWorkFormProcessor(UserAgent t UserData, IRemoteRepository, HttpServletRequest) 

Operations 

addEmailSupportODataSource, IDataEventSource) 

addSmsSupport(IDataSource, IDataEventSource) 

applyChangeOnlyO 

applyDestinationFieldsQ 

applylsRunningO 

applyTimerFields() 

getWorkerChangeOnlyFilter() 

process Form() 
^ removeEmailSupport(IDataEventSource) 
fc^ removeSmsSupport(IDataEventSource) 




I |fc dataWorker 

protected DataWorker dataWorker = null 

infoServerAccess 

protected IRemoteRepository infoServerAccess = null 
jLJfl request 

^HttpServletRequest request = null 

rll userAgent 

protected UserAgent userAgent = null 

A userData 

protected UserData userData = null 
ft UserWorkFormProcessor 

public UserWorkFormProcessor (UserAgent ua, UserData ud, IRemoteRepository ir, HttpServletReques 
request) 

Called from the JspBean when we need to apply the results of having clicked on a form generated bby the UserWorkFormGenerator 



addEmailSupport 

protected void addEmailSupport ( IDataSource dataSource, IDataEventSource evtSource) 
add Email listener to this source TO DO: Puli Email constants from property file 
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• addSmsSupport 

protected void addSmsSupport (IDataSource dataSource, IDataEventSource evtSource) 
add Email listener to this source TO DO: Pull SMS constants from property file 

• appIyChangeOnly 

protected void appIyChangeOnly ( ) 

Add or Remote a ChangeOnlyFilter, as directed by the checkbox. 

Throws: 

Exception 

$ applyDestinationFields 

protected void applyDestinationFields ( ) 

Apply the request to add/remove Destination TO DO: Make sure that what's happening with appIyChangeOnly does not strangely affect 
this and vice-versa 

• applylsRunning 

protected void apply I sRunning ( } 
Check and apply the isRunning field 

Throws: 

Exception 

% applyTimerFields 

protected void applyTimerFields ( ) 

11 apply the timer fields; taking into special consideration the 'combined' time possibilities 

\M Throws: 

y s | Exception 

getWorkerChangeOnlyFilter 

fybrotected ChangeOnlyFilter getWorkerChangeOnlyFilter ( ) 

~; Return a ChangeOnlyFilter that may be assigned to the dataWorker. If none is assigned, return null 

htk processForm 

F public boolean processForm ( ) 

Check each of the possible fields and then save the agent return false if the form could not be processed; Note: We could also throw an 
exception to give more detail; 

if removeEmailSupport 

protected void removeEmailSupport (IDataEventSource source) 
Remove EmailDestination from the DataEventSource 

• removeSmsSupport 

protected void removeSmsSupport (IDataEventSource source) 
Remove SmsDestination from the DataEventSource 

S Class tcs.ain.infoserver.SMSUserDestination 

public class SMSUserDestination 
Extends: 

tcs.ainJnfoserver.UserDeliveryDestination 
This sends its data via RM1 to the Web Gateway's queue 
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Attributes 

destMin 
queue 

remoteAddress 

Constructors 

SMSUserDestinationO 

Operations 

cleanUpO 

getDestMin() 

getRemoteAddress() 

getRMIconnected() 

getSaveables() 

makeRMIConnectionO 

process Data(DataEvent) 

sendShortMessage(String, String) 

setDestMin(String) 

setRemoteAddress(String) 

setSaveab!es(Object[]) 



Attribute Detail 



• destMin 

^protected String destMin 

yi The MIN where we will send the message 

fjl queue 

EJjprotected static IQueueProxy queue - null 
4* the remote queue object for inserting messages 

fjfl remoteAddress 

^protected String remoteAddress = "localhost" 

fl 

The address of the RemoteQueue 

III 




mmmmim 



tjk SMSUserDestination 

public SMSUserDestinationO 




& cleanllp 

public void cleanup () 
Clean up data 

f> getDestMin 

public String getDestMin () 

<i getRemoteAddress 

public String getRemoteAddress ( ) 

• getRMIconnected 

protected boolean getRMIconnected ( ) 

make connection if necessary; test the connection; if failed, try to to remake the connection return true if good connection 
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Throws: 

Exception 

• getSaveables 

public Object [] getSaveables { ) 

Return an array of all objects that should be persistent, primitive datatypes must be converted to their Object equivalent. These objects 
will come back in the same order when setSaveables is called. 

• makeRMIConnection 

protected void makeRMIConnection { J 

Connect the remote object to the server if necessary 

Throws: 

Exception 

A processData 

public void processData {DataEvent evt) 
I have new data; it to the gateway 

Throws: 

SMSUserDestinationException 

sendShortMessage 

^.protected void sendShortMessage (String address, String msgTxt) 
Send a short message 

III 

P Throws: 

Exception 

m 9t setDestMin 

ii 

^public void setDestMin (String destMin) 

yli setRemoteAddress 

f^jpublic void setRemoteAddress (String addr) 

jjjl setSaveables 

public void setSaveables (Object [] oa) 

receive an array of objects that have been saved, the order will correspond to that specified when getSaveables was called. Users should 
handle Null values in the array. 



B Class tcs, a/n. infoserver. SMSUserDestinationException 

public class SMSUserDestinationException 
Extends: 

tcs.ain.infoserver.lnfoServerException 



Constructors 

SMSUserDestinationException(String) 



ctor Detail 



wmmmrn 



Wt SMSUserDestinationException 

public SMSUserDestinationException (String s) 
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B Class tcs.ain.infoserver. tests. GSWDS 

public class GSWDS 

Tests the iMAP Query Engine; query every one minute 
Constructors 

GSWDSO 

Operations 

main(String[]) 



^^^^^^^^^^^^^^^^^^^^^^^^^^^ 



• GSWDS 

public GSWDSO 

Throws: 

Exception 



sraf 



HJH main 

Lie static void main (String [ 3 args) 



JfP Class tcs.ain.infoserver.tests. Testl 

Jpublic class Testl 

class create a WebQueryEngine, 2 DataWorkers, SimpleUserDestination and ties them all together. The dataworker will execute once, 
fjlausing the XML from the horoscope web page to be seen on the screen. 

ffponstructors 

flf- Testl() 

Operations 

main(String[]) 



m Testl 

public Testl ( ) 

• main 

public static void main (String [3 args) 

B Class tcs.ain.infoserver.tests.TestlO 

public class TestlO 
Adds on to Test3 by saving to the Repository. 



Constructors 

Test 10() 
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Operations 

main(String[]) 




m TestlO 

public TestlO () 

Throws: 

Exception 




9t main 

public static void main (String [] args) 

D Class tcs.ain.infoserver.tests.Testl 1 

public class Testll 

Tests the I MAP Query Engine; query every one minute 

^Constructors 

Si TestllO 

^Operations 

main(String[]) 

SB! 5 




* m Testll 

public TestllO 

ft! Throws: 

Q Exception 




• main 

public static void main (String [] args) 



m Class tcs.ain.infoserver.tests. Testl2 

public class Testl2 

This test just shows ail of the Data Sources and interleaves userUser info If the user has 'signed up' with this source, then user info is shown. 

Attributes 

agentWorkers 
rep 

userAgent 
Constructors 

Testl2(String) 

Operations 

main(String[]) 
showAi I U serWorkersQ 
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showtnfo() 

showUserMatch(String) 




• agentWorkers 

DataWorker [ ] agentWorkers = null 

9: rep 

IRemoteRepository rep = null 

• userAgent 

UserAgent userAgent = null 



» Testl2 

public Testl2 (String uName) 



*Sl main 

iublic static void main (String [] args) 



showAI I UserWorkers 

3 protected void showAHUserWorkers { ) 

showlnfo 

protected void showlnfo (} 

l2i Throws: 
• U Exception 

showUserMatch 

^protected void showUserMatch (String sourceKey) 



H Class tcs.ain.infoserver.tests. Test2 

public class Test2 

Adds on to Testl by assigned an XSL doc to the DataSource, and assigning a formatter that uses that XSL doc. 

Constructors 

Test2() 

Operations 

main(String[]) 

• Test2 

public Test2 ( ) 

Throws: 

Exception 
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• main 

public static void main (String [] args) 

B Class tcs. ain.infoserver. tests. Test3 

public class Test3 
Adds on to Test2 by using the CaiendarTimer. 

Constructors 

Test3() 

Operations 

main(String[]) 



motor Detail 



• Test3 

public Test3 () 

sss, Throws: 
% % Exception 

■/■I 

Operation Detail 



III- 

main 

public static void main (String [] args) 

tot* 



Class tcs. ain.infoserver. tests. Test4 



HI 



public class Test4 
J^fxtends: 

J! java.lang. Object 



"Constructors 

Test4() 

Operations 

main(java.iang.String[]) 



m Test4 

public Test4 ( ) 



rton Detail 



• main 

public static void main(java . lang. String [] } 



H Class tcs.ainJnfoserver.tests. Test5 

public class Tests 



Loads the objects saved in Test4. 
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Constructors 

TestSQ 

Operations 

main(String|]) 



Constructor Detail 



m Tests 

public Test 5 ( ) 

Throws: 

Exception 

<i main 

public static void main (String [] args) 

ClH Class tcs.ain.infoserver.tests. Test6 

^public class Teste 

fCBets the InfoserverAccess object. Creates an UserAgent and saves it to the InfoServerAccess remote object. 

Jffionstructors 

iil Testeo 



^Operations 

main(String|]) 



swuczor uezan 



M» Test6 

^public Teste (} 

Throws: 

Exception 



# main 

public static void main {String [ 3 args) 



H Class tcs.ain.infoserver.tests.Test7 

public class Test7 

Gets the InfoserverAccess object. Retrieves the UserAgent saved in Test6. 

Constructors 

Test7() 

Operations 

main(String[]) 
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a Test7 

public Test7 { ) 

Throws: 

Exception 



\tion Detail t 



• main 

public static void main {String [] args) 

B Class tcs.ain.infoserver.tests. Test8 

public class Test8 

Tests the 1MAP Query Engine; query every one minute 

Constructors 

Test8() 

QDperations 



main(String[]) 




4Wt Test8 

public Test8{) 

a Throws: 

fn Exception 



Ufl main 

'""public static void main (String [] args) 



H Class tcs.ain.infoserver.tests. Test9 

public class Test9 

Single worker, single data source for I MAP, with 2 XSL styles. Two destinations, each using a different style sheet. Dest 1 inserts the Email 
data into a database for the IVR reader Dest 2 displays the at the Ml N. 

Constructors 

Test9(String, String, String) 

Operations 

main(String[]) 



m Test9 

public Test9 (String emailServer, String emailAcct, String eraailPW) 



Throws: 

Exception 
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•f main 

public static void main (String [] args) 

B Class fcs. ain. infoserver. tests. TestPageParserQE 

public class TestPageParserQE 

This creates a PageParserQueryEngine and has a DataWorker query it 

Constructors 

TestPageParserQE() 

Operations 

main(String[]) 



Mfl TestPageParserQE 

i! 

^public TestPageParserQE ( ) 

"'it 

S! Throws: 

If! Exception 



main 

fgublic static void main (String [] args) 

I 

'56 Class tcs.ain.infoserver.tests. WLabDS 

public class WLabDS 
Tests the I MAP Query Engine; query every one minute 

Constructors 

WLabDSO 

Operations 

main(String[]) 



■■■HlHHi 



• WLabDS 

public WLabDSO 

Throws: 

Exception 
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HI 



i-.-.jrsi.v 



• main 

public static void main {String [] args) 



E3 Class tcs. ain.infoserver. TimeElement 

public class TimeElement 

Implements: 

javaJo.Serializable 
tcs.persist.TCSPersistent 

This provides services for identifying time elements used by the CalendarTimer. Can represent minutes, hours, day of week, etc. 

Attributes 

timeUnit 
timeValues 

Constructors 

TimeElementO 

Operations 

addValue(int) 
Q doAlways() 
. getSaveables() 

getTimeUnit() 

getTimeValues() 
g| getValuesO 
|V| hasMatch(Date) 
"Jl isDoAlwaysO 
4* removeAIITimerValuesO 
|l| setSaveables(Object[]) 

setTimel)nit(int) 

setTimeValues(Vector) 

1 ^-^r^^iM life ^ cS&3^ r?"V • 

LP timeUnit 

private nit timeUnit 

s » 

jL^ Day of week, Day of Month, etc 
• timeValues 

private Vector timeValues - new Vector () 

The list of values that can be matched against a time in hasMatch for the assigned timeUnit 



• TimeElement 

public TimeElement ( ) 



Operation Detail 



HUH 



■HBP 



EM 



• addValue 

public void addValue (int value) 

Add a value that will indicate a valid time. When has Match (Date) is called, we check against values populated with this method using the 
current time unit. 
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if doAIways 

public void doAlways() 

Set this timer to run at every interval (doAIways) 

• getSaveables 

public Object [] getSaveables ( ) 

• getTimeUnit 

public int getTimeUnit ( ) 
tgGet 

• getTimeValues 

public Vector getTimeValues ( ) 
tgGet 

9 getValues 

public int[] getValues () 

Return an array of the values that have been assigned. 

dH hasMatch 

public boolean hasMatch {Date mdate) 

f jl Whether we have a time value that matches the received Date for the assigned timeUnit 
%fa isDoAlways 

Sis; 5. 

-/public boolean isDoAlwaysO 

111 Whether we are assigned to always have a match for the time unit 

fH removeAIITimerValues 

public void removeAIITimerValues ( ) 
\H Remove all time values 

CP setSaveables 

public void setSaveables {Object [] oa) 

• setTimeUnit 

public void setTimeUnit (int timeUnit) 
tgSet 

• setTimeValues 

public void setTimeValues {Vector v) 
tgSet 

H Class tcs.ain.infoserver. Timer 

public class Timer 

Extends: 

javaJang.Thread 

Implements: 

java.io.Serializable 
tcs.persist.TCSPersistent 
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Used by Worker to control when the worker should do its work. Different types of timers can fire according to time elapsed, # of events, time 
of day, etc. This timer just fires once at start. 

Attributes 

worker 

Constructors 

Timer() 

Operations 

getSaveabies() 

getWorkerO 

run() 

setSaveabies(Object[]) 
setWorker(Worker) 

• worker 

protected Worker worker 




yH getSaveables 

^public Object [3 getSaveables ( ) 

PI Return an array of all objects that should be persistent, primitive datatypes must be converted to their Object equivalent. These objects 
J; wiil come back in the same order when setSaveables is called. 

fill getWorker 

public Worker getWorker () 

Nft run 

public void run() 

When the thread runs, tell the worker to do its work 

• setSaveables 

public void setSaveables (Object [] oa) 

receive an array of objects that have been saved, the order will correspond to that specified when getSaveables was called. Users should 
handle Null values in the array. 

• setWorker 

public void setWorker (Worker worker) 

B Class tcs.ain.infoserver. UserAgent 

public class UserAgent 
Extends: 

tcs.ain.infoserver. InfoServerElement 

UserUser is a collection of information about the User. It also collects all of the InfoServerElements desgnated to this user. The user's 
workers, dataDestinations, private dataSources, etc. are contained by this user. 
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Attributes 

email 

fName 

IName 

mobileNumber 
userElements 

Constructors 

UserAgent() 

Operations 

addElement(lnfoServerElement) 

getANDataWorkersO 

getAIIEIements() 

getDataWorker(Stri ng) 

getEmail() 

getFName() 

getLName() 

getMobileNumber() 

getSaveablesO 

getUserElements() 

getWorkerJds() 

removeElement(l nf oServerElement) 

setEmail(String) 

setFName(String) 

setLIMame(Slring) 
^ setMobileNumber(String) 
M setSaveables(ObjectO) 
it) setUserElements(Vector) 
k^j startWorkers() 
^ stopWorkers() 




Jy email 

^private String email = new String () 



gfl fName 

private String fName 

Hi 

^3p IName 

yprivate String IName 

9t mobileNumber 

private String mobileNumber 
• userElements 

private Vector userElements = new Vector () 



• UserAgent 

public UserAgent () 



Detail 



9 addEIement 

public void addEIement ( Inf oServerElement e) 
Add an InfoServer Element for the user 
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if getAI I Data Workers 

public DataWorker[] getAllDataWorkers ( } 
Return an array of all the Data Workers that I possess * 

• getAIIEIements 

public InfoServerElement [] getAIIEIements { ) 

Return an array of al! the InfoServerElements I possess (This could be of various types* 

• getDataWorker 

public DataWorker getDataWorker (String workerld) 

• getEmaii 

public String getEmaii {) 
tgGet 

• getFName 

public String getFName {) 
tgGet 

■Mfc getLName 

^public String getLName () 

lU tgGet 

II! 

4ll getMobileNumber 

^f;jbublic String getMobileNumber ( ) 

» tgGet 

HP getSaveables 

Itjbublic Object [] getSaveables ( ) 

pi 

JjJ Return an array of all objects that should be persistent, primitive datatypes must be converted to their Object equivalent. These objects 
Ui will come back in the same order when setSaveables is called. 

• getUserElements 

public Vector getUserElements { ) 

tgGet 

• getWorkerlds 

public Vector getWorkerlds ( ) 

Return an array of all the DataWorkers that I possess * 

• removeElement 

public void removeElement (InfoServerElement e) 
Remove an infoServer Elements from the user 

• setEmail 

public void setEmail (String email} 
tgSet 
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• setFName 

public void setFName (String fName) 
tgSet 

• setLName 

public void setLName (String IName) 
tgSet 

• setMobileNumber 

public void setMobileNumber (String mobileNumber) 
tgSet 

• setSaveables 

public void setSaveables (Object [] oa) 

receive an array of objects that have been saved, the order will correspond to that specified when getSaveables was called. Users should 
handle Null values in the array. 

• setUserElements 

^public void setUserElements (Vector userElements) 

tfl tgSet 

Bffc startWorkers 

^public void startWorkers ( } 

$\i Start all the workers assigned to me if they should be running. Called when de-serialized by Repository. 
*$tt stopWorkers 

."-public void stopWorkers ( ) 

f|| Stop all the workers assigned to me. 

tlB Class tcs.ain.infoserver. UserDeliveryDestination 

^public abstract class UserDeliveryDestination 
Extends: 

tcs.ain.infoserver.lnfoServerElement 

Implements: 

tcs.ain.infoserver.lDataEventListener 

This implementation uses a DataFormatter for retrieving the info from the DataSource and returning a String representation. Subclasses of 
this will implement the deliverData() method, which will take the string representation of the data and send it to the end-user in an 
appropriate manner. 

Attributes 

dataDestinations 
formatter 

Constructors 

UserDeliveryDestination() 

Operations 

cleanUpO 

getFormatter() 

processData(DataEvent) 

setForrnatter(DataFormatter) 
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• dataDestinations 

protected Vector dataDestinations 

Associates: 

IDataEventListener 

• formatter 

protected DataFormatter formatter = new DataFormatter ( } 
Default Data Formatter 



H UserDeliveryDestination 

public UserDeliveryDestination { ) 




9: cleanUp 

public abstract void cleanup (} 

TV Required method for a IDataEventListener. What tells me that I should examine a data source. 
W| getFormatter 

3., 5 R 

^public DataFormatter getFormatter { ) 

sib? 

Ill tgGet 

m 

s • processData 

Wpublic abstract void processData (DataEvent evt) 

jp;:j; Required method for a IDataEventListener. What tells me that I should examine a data source. 
C| Throws: 

P| InfoServerException 
# setFormatter 

public void setFormatter (DataFormatter formatter} 
tgSet 



B Class tcs.ain.infoserver.WebQueryEngine 

public class WebQueryEngine 
Extends: 

tcs.ain.infoserver.JDBCQueryEngine 
This handles querying a web page, internally uses a JDNC driver which reads HTML. 

Attributes 

CiassName 

Constructors 

WebQueryEngine(String, String) 
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• ClassName 

protected static String ClassName = "f r .dyade .mediation. InfoExtractor . jdbc. IEDriver" 



S> WebQueryEngine 

public WebQueryEngine (String driverUrl, String queryStr) 
Receive the URL name to query. We internally provide the Web JDBC Driver 

B Class tcs.ain.infoserver. Worker 

public abstract class Worker 
Extends: 

tcs.ain.infoserver. infoServerElement 

Implements: 

tcs.persist.TCSPersistent 

Worker has its own thread and actually initiated actions within the InfoServer environment. Workers are typically defined by/for UserAgents 
and initiatiate interaction between other InfoServerElements. Base class handles default details of when the worker should do its work by 

Of sing the Timer class. Timer is a special thread that is used to determine when the Worker should do its work. Subclasses must provide th< 

^ioWorkQ method, which is called whenever the thread executes. 



fj| WorkerO 

tPperations 

|{ doWork() 

HI getlsRunningQ 

fff getTimer() 

setlsRunning(boolean) 
r! setTimer(Timer) 
U start() 

m stopo 



$ isRunning 

protected boolean isRunning = false 

Internal flag for whether we are running; used when loading serialized image to auto-start 

• timer 

protected Timer timer = null 

The timer that drives when the worker does work. 





I ^Constructors 






>r Detail 




SI Worker 



public WorkerO 
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m doWork 

public void doWorkO 

This is the method called by my timer whenever I should do some work. Subclasses must define this. 

• getlsRunning 

public boolean getlsRunning { ) 
tgGet 

9t getTimer 

public Timer getTimer () 
tgGet 

• setlsRunning 

public void setlsRunning (boolean b) 
tgSet 

setTimer 

^public void setTimer (Timer timer) 
^tgSet 

§1 start 

^public void start () 

% stop 

ppublic void stopO 

1 




iSSHBHHHBRlSEnHKS 



y<> Interface tcs. ain.infoserver.access. IRemoteRepositorv 

public interface IRemoteRepositorv 

Extends: 

java.rmi. Remote 

This interface provides access to user agents within the Info Server. May be replaced by a Jini Service in the near future. 

Operations 

addUserAgent(UserAgent) 

getQueryEngine(String) 

getQueryEngines() 

getU serAgent(Stri ng) 

getWorkerldsFromAgent(String) 

isConnected() 

launchWorker(String, String, Hashtable) 
launchWorker(String, String) 



Operate 



• addllserAgent 

public abstract void addUserAgent (UserAgent ua) 
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Throws: 

infoServerException 
RemoteException 

• getQueryEngine 

public abstract QueryEngine getQueryEngine (String id) 

Throws: 

ElementNotFoundException 
RemoteException 

• getQueryEngines 

public abstract Hashtable getQueryEngines ( ) 

Throws: 

RemoteException 

• getUserAgent 

public abstract UserAgent getUserAgent (String id) 

Throws: 

ElementNotFoundException 
RemoteException 

ij§ getWorkerldsFromAgent 

public abstract Vector getWorkerldsFromAgent (String id) 

HI Throws: 

J: RemoteException 

Lii.| 

SJfl- isConnected 

Si public abstract boolean isConnected { ) 
J* Throws: 

l}l ElementNotFoundException 
ill RemoteException 

|3§ launchWorker 

f- s |>ublic abstract String launchWorker (String id, String workerld, Hashtable htParams) 

Throws: 

I nf oServerException 
RemoteException 

• launchWorker 

public abstract String launchWorker (String id, String workerld) 

Throws: 

InfoServerException 
RemoteException 

O Interface tcs.ain.infoserver.IDataEventListener 

public interface iDataEventListener 

Extends: 

java. uti I . EventLi stener 

Operations 

cieanUpQ 
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processData(DataEvent) 



n 



» cleanup 

public abstract void cleanup () 

• processData 

public abstract void processData (DataEvent evt) 

Throws: 

i nf oServerExcepti on 

& interface tcs.ain.infoserver.lDataEventSource 

public interface IDataEventSource 

Operations 

addDataEventListener(l Data EventListener) 
get Data Even t Li stener(String) 
getDataEventListenersQ 
removeDataEventListener(IDataEventListener) 



addDataEventListener 

Public abstract void addDataEventListener (IDataEvent Listener 1) 



getDataEventListener 

"public abstract IDataEvent Listener getDataEventListener {String id} 

ft getDataEventListeners 

republic abstract Enumeration getDataEventListeners ( ) 

Hfc remove Data EventListener 

iublic abstract void removeDataEventListener (IDataEventListener 1} 



O I nterf ace tcs.ain. infoserver.lDataSource 

public interface IDataSource 

This interface defines what to expect from an information supplier. Ideally a data source will provide; - some data - a definition of the data 
(DTD) - some ways to display the data The iast is optional. The DTD is a good idea, but is not yet enforced. 

Operations 

getDTDO 

getXMLStreamO 
getXSLDocCount() 
getXSLDocument(String) 
getXSLName(int) 



Operation Detail 



» getDTD 

public abstract DTD getDTDO 

return a DTD describing the XML that can be retreived using the XML Stream. 
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ft getXMLStream 

public abstract InputStream getXMLStream {) 

Return an input stream by which an XML document can be read. We return an INputStream rather than just a DOM XML document 
because: - some data may be too large to process as a single unit - this way multiple XML parsing techniques (SAX, DOM, etc) can be 
used at the discretion of the client. The XML Stream does NOT included DTD info. 

Throws: 

I nf oServer Excepti on 

ft getXSLDocCount 

public abstract int getXSLDocCount () 

How many XSL documents are provided for presenting the data 

ft getXSLDocument 

public abstract org. w3 c .dom. Document getXSLDocument (String name) 
The actual XSL Document with this name 

ft getXSLName 

public abstract String getXSLName ( int idx) 

The descriptive name for XSL document with this index position (0-based) 

yuQ Interface tcs.ain.infoserver.pqa.PQAConst 

fsfublic interface PQAConst 

IJthe Interface is a contains common constants which apply to the QueryNet PQA interface, modified by S. Levine on 9/9/99 

J** 

Idbttributes 

is":;' 

ffl CANCEL 

DEBUGMODE 
!L I N VALI D LOG I N_TAG 
O LAUNCH 
Hi LOGIN_PATH 
w\ MENLLPATH 
L!f NOWORKERS_PATH 
W NO_RESULTS_MSG 
CI RESULTSJTAG 
= RESULT_PATH 
r " SECTION 

USERNAME 

USERNAME.TAG 

WORKERID_TAG 

WORKERLIST 

WORKERLIST_TAG 

ft CANCEL 

String CANCEL = " CANCEL " 
Form Cancel Button. 

ft DEBUGMODE 

boolean DEBUGMODE = Boolean . valueOf {QNetPQARe source . getSt ring ( "DebugMode "))- booleanValue ( ) 
Specifies whether app is in debug mode 

ft I N VALI DLOGI N_T AG 

String I NV ALI DLOG I N_TAG = "<!-- I NVAL I DLOG I NMS G -->" 
Form Tag that lets up put dynamic Invalid Login Message in static html 
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m LAUNCH 

String LAUNCH = " LAUNCH " 
Form Launch Button. 

• LOGIN„PATH 

String LOGIN_PATH = QNetPQARe source .get St ring ( "LoginPath" ) 
Path to Login page 

• WIENU.PATH 

String MENU_PATH = QNetPQARe source .getString ( "MenuPath" ) 
Path to Menu page 

• NOWORKERS_PATH 

String NOWORKERS_PATH = QNetPQAResource . getString ( "NoWorkersPath" ) 
Path to No Workers page 

• NO_RESULTS_MSG 

String NO_RESULTS_MSG = QNetPQAResource. getString {"NoResultsMsg") 
No Results Returned from QueryNet Message 

5fl RESULTS_TAG 

^ftring RESULTS JTAG = "<!-- RESULTS -->" 

ftl Form Tag that lets up put dynamic result information in static html 

i if 7; 

m RESULT_PATH 

wfetring RESULT_PATH = QNetPQAResource.getStringC'ResultPath") 
^ Path to Results page 

Cf| SECTION 

■jrfetring SECTION = "SECTION" 

III 

f s | Form Section Id Hidden Field. 
Hi USERNAME 

String USERNAME = "USERNAME" 
Form Hidden Field containing a Userld 

• USERNAME_TAG 

String US ERNAME_TAG = "<!-- USERNAME -->" 

Form Tag that lets up put dynamic UserName information in static html 

• WORKERID_TAG 

String WOR KE R I D_T AG = "<!-- WORKERID -->" 

Form Tag that lets up put dynamic Workerld information in static html 

9t WORKERLIST 

String WORKERLIST = " WORKERLIST" 
Form Listbox containing a list of worker ids. 

& WORKERLISTTAG 

String WOR KERL I S T_T AG = "<!-- WORKERLIST -->" 

Form Tag that lets up put dynamic WorkerList ListBox in static html 
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O Interface tcs.ain.infoserver.servletlSEIementCreator 

public interface I SE1 ement Creator 

Attributes 

CLASS 

CUSTOMSOURCE_ET 

DELIMIT 

DESCRIPTION 

DESTi NATION_ET 

FORMATTER 

NAME 

REQUIRED 

STYLES 

Operations 

getCustomSource(String, HttpServletRequest, StringBuffer) 
getDestination(String, Vector, StringBuffer) 
getElementNames(int, boolean) 
getFormatStyle(UserDeiiveryDestination) 
getFormatter(QueryEngine, String) 

getRequiredData(String f InfoServerElement, UserAgent, int) 
getRequirements(String, int) 

getSubForm(String, InfoServerElement, UserAgent, int) 
loadElementsCString, String) 

if 1 CLASS 

String CLASS = "CLASS" 
J! Element Attribute 

i^jl CUSTOMSOURCE_ET 

Jint CUSTOMSOURCE_ET = 0 
Ci Element Type 

ffl DELIMIT 

Qtring DELIMIT - "~" 
String Delimiter 

m DESCRIPTION 

String DESCRIPTION = "DESC" 
Element Attribute 

m DESTINATIONS 

int DESTINATION_ET = 1 

Element Type 
m FORMATTER 

String FORMATTER = " FORMATTER " 
Element Attribute 

• NAME 

String NAME - "NAME" 
Element Attribute 

• REQUIRED 
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String REQUIRED = " REQUIRED " 
Element Attribute 

m STYLES 

String STYLES = "STYLES" 
Element Attribute 

• getCustomSource 

public abstract QueryEngine getCustomSource {String source, HttpServlet Request request, StringBuffer 
errorMsg) 

• getDestination 

public abstract UserDeliveryDestinat ion getDestination (String destination, Vector reqlnfo, 
StringBuffer errorMsg) 

• getElementNames 

public abstract Vector getElementNames (int elementType, boolean addDesc) 

pi getFormatStyle 

public abstract String getFormatStyle (UserDeliveryDestinat ion dest) 

ftjji getFormatter 

^public abstract DataFormatter getFormatter (QueryEngine ds, String style) 

if* getRequiredData 

public abstract Vector getRequiredData (String destld, Inf oServerElement element, UserAgent agent, 
!j K j.nt elementType) 

l*P getRequirements 

Llijpublic abstract Vector getRequirements (String name, int elementType) 

^ getSubForm 

'public abstract String getSubForm (String name, Inf oServerElement element, UserAgent agent, int 
elementType) 

9 loadElements 

public abstract void loadElements (String sourceElements , String destElements) 
Load elements descriptions into hashtables 

z** 

SMI Collaboration Diagram overview 
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Fl.l.l/get data 



: IPataSource 



1. l//getXMLStream{) : InputStr^nti 



: UserPelj-veryPes tinati 



l//processData (DataEvent) : 



: UserAgent 



:DataWorker 



1 

m 
hi 
$ 
iii 
ar 

basic component relationships 

I' 



1 . 2//getDataStnng ( IDataSource) rSttlii' f 



: DataFormatte 




rl.3/send data 



Subscriber 



Data 

Subscriber 




Object 



Instantiates: 

tcs.ain.infoserver. IDataSource 



get data to Object Data 

Number: 

1.1.1 

Synchronization: 

cali 
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processingDuration: 

50 

sendinglnstant: 

175 



Object 

Instantiates: 

tcs. a in.inf oserver. UserAgent 



to Object 



Object 

Instantiates: 

tcs . ai n . i nf oserver. Data Formatter 



^ Object 



^1 Instantiates: 



tcs. ain.inf oserver. UserDeliveryDesti nation 

to Object 

Number: 

1.1 

Synchronization: 

cali 

processingDuration: 

80 

sendinglnstant: 

155 

Operation: 

tcs . ai n . i nf oserver. i DataSou rce.getXM LStrea m() 

operation NameAsText: 

'getXMLStreamOilnputStream' 

send data to Object Subscriber 

Number: 

1.3 

Synchronization: 

call 

processingDuration: 

50 

sendinglnstant: 

325 



to Object 
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Number: 

1.2 

Synchronization: 

call 

processingDuration: 

50 

sendinglnstant: 

255 

Operation: 

tcs.ain.infoserver.DataFormatter.getDataString(tcs.ainjnfoserver.lDataSource) 

operation Na meAsText: 

'get DataString(l DataSou rce): String 1 



Object 

Instantiates: 

tcs.ain.infoserver.DataWorker 

multiple instances 

to Object 

Number: 

1 

Synchronization: 

call 

processi ngDuration: 

250 

sendinglnstant: 

135 

Operation: 

tcs.ainjnfosewer.UserDeliveryDestinati 

operation NameAsText: 

'processDataCDataEventyvoid' 

to Object 

Object Data 

Stereotype: 

actor 



Object Subscriber 

Stereotype: 

actor 
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Package tcs.ain.infoserver.access 



Class Diagrams 

diagram access 

ffi Classes 

class tcs.ain.infoserver.access. InfoServerAccess 
class tcs.ain.infoserver.access. lnfoServerAccess_Skel 
class tcs.ain.infoserver.access. lnfoServerAccess_Stub 

O Interfaces 

interface tcs.ainJnfoserver.access.lRemoteRepository 



Class Diagrams 



111 



Iflil 



Class Diagram access 



j ava . rmi . Remot 
interface 
IRemoteRepositozy 



disconnected: boolean 

+ge tUserAgent : UserAgen t 

+a ddUs er Agent :void 

+getQuery Engines : Hashtable 

+getQuery Engine : QueryEngine 

+ ge two rke rids From Agent : Vector 

+ launchWorker : String 

-h launchWorker : String 
fi 



UnicastReraoteObjec 
InfoServerAccess 



# repository : Repository 



-FisConnected: boolean 
+InfoServerAccess 
+getUserAgent : UserAgent 
+addUserAgent : void 
+getQueryEngines : Hashtable 
+getQueryEngine : QueryEngine 
+getWorkerIdsFromAgent : Vect 
4-launchWorker: String 
+launchWorker : String 



connected: boolean 
queryEngines : Hashtable 



j ava . lang. Obj 
j ava . rmi . server . Skel 
InfoServerAccess Skel 



-operations : i ava . rmi . server . 
-interf aceHash: long 



+Inf oServerAccess_Skel 
+dispatch : void 



operations : j ava . rmi . server . 



j ava . rmi . server . Remotes 
j ava . rmi . Remot 
Inf o ServerAcces s S tub 

-operations : i ava . rmi . server . 

-interf aceHash: long 

+Inf o S e r ve rAcce s s_S t ub 
+Inf oServerAccess_Stub 
+addUserAgent : void 
+getQueryEngine : tcs . ain . info 
+getUserAgent : tcs . ain . inf ose 
+getWorkerIdsFromAgent : j ava . 
+launchWorker : j ava . lang . Stri 
+launchWorker : j ava . lang . Stri 

queryEngines : j ava . util . Hash 

connected : boolean 
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Class Nodes 

tcs.ain. infoserver.access.lnfoServerAccess 
tcs.ain. infoserver.access.lnfoServerAccess_Ske! 
tcs.ain . inf oserver. access. I nfoServerAccess_Stub 

Interface Nodes 

tcs.ain. infoserver.access.lRemoteRepository 



Class tcs.ain. infoserver.accessJnfoServerAccess 



This class provides access to user agents within the Info Server. May be replaced by a Jini Service in the near future. This provides 
access to the assigned Repository 

Extends: 

UnicastRemoteObject 

Implements: 

IRemoteRepository 



tiol^jmi!^^^. 
to Interface IRemoteRepository 



m 



1 Class tcs.ain. infoserver.access.InfoServerAccess_Skel 

Extends: 

java.lang.Object 

Implements: 

java.rmi.server.Skeleton 

I Class tcs.ain. infoserver.access.lnfoServerAccessJStub 

Extends: 

java.rmL server. RemoteStub 

Implements: 

tcs.ain. infoserver.access.lRemoteRepository 
java.rmt. Remote 



to Interface IRemoteRepository 



& Interface tcs.ain. infoserver.access. IRemoteRepository 

This interface provides access to user agents within the Info Server. May be replaced by a Jini Service in the near future. 



Extends: 

java.rmi, Remote 



Class tcs.ain. infoserver.access. InfoServerAccess 



public class InfoServerAccess 
Extends: 
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java. rm i . server. U n icastRemoteObject 

Implements: 

tcs.ain.infoserver.access.tRemoteRepository 

This class provides access to user agents within the info Server. May be replaced by a Jini Service in the near future. This provides access to 
the assigned Repository 

Attributes 

repository 

Constructors 

I nf oServerAccess(Repos itory) 

Operations 

addUserAgent(UserAgent) 

getQueryEngine(String) 

getQueryEngines() 

getUserAgent(String) 

getWorkerlds From Agent(St ring) 

isConnected() 

launchWorker(String, String, Hashtabie) 
launchWorker(String, String) 



^fJUt repository 

^protected Repository repository 

'"si 

fp The repository which we represent 



H1H I nfoServer Access 

^public Inf oServerAccess {Repository r) 

fl I Construct with this repository and register the 'InfoServerAccess' name. 

fl| Throws: 

Q RemoteException 

MalformedURLException 



• addUserAgent 

public void addUserAgent ( User Agent ua) 

Pass through the add, but also force a save of ali agents. 

Throws: 

I nf oServerException 
RemoteException 

• getQueryEngine 

public QueryEngine getQueryEngine (String id) 
Direct passthrough for the get 

Throws: 

RemoteException 

• getQueryEngines 

public Hashtabie getQueryEngines ( ) 
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Direct passthrough for the get 

Throws: 

RemoteException 

• getUserAgent 

public UserAgent getUserAgent (String id) 
Direct passthrough for the get 

Throws: 

RemoteException 

9 getWorkerldsFromAgent 

public Vector getWorkerldsFromAgent (String agentld) 
Return all id's associated with a specified agent 

Throws: 

RemoteException 

© isConnected 

public boolean isConnected ( } 

Used for testing an RMI Connection. Always sends true. If client calls this and no connection has been establishished then they will get an 
exception 

Throws: 

ElementNotFoundException 
yi RemoteException 

111 

4^1 launchWorker 

^public String launchWorker (String agentld, String workerld, Hashtable htParams) 

Call the specidied workers doWork method, pass in parameters. 
C| Throws: 

|1I InfoServerException 
s% I RemoteException 

SSI launchWorker 

ypublic String launchWorker (String agentld, String workerld) 
Call the specidied workers doWork method 

Throws: 

InfoServerException 
RemoteException 



H Class fcs.a/n. infoserver.access. I n foServer Access Skel 

public final class Inf oServerAccess_Skel 

Extends: 

java.lang.Object 

Implements: 

java . rm i . server. S kel eton 

Attributes 

interfaceHash 
operations 

Constructors 

lnfoServerAccess_Skef() 
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Operations 

dispatch(java. rmi. Remote, java. rmi. server. RemoteCal I, int, long) 
getOperationsQ 



• interfaceHash 

private static final long interfaceHash 

• operations 

private static final java. rmi . server .Operation [] operations 



• lnfoServerAccess_Skel 

public Inf oServerAccess_Skel { ) 



m 



& dispatch 

^•public void dispatch (java. rmi .Remote, java . rmi . server . RemoteCal 1 , int, long) 
getOperations 



f;l>ublic j ava . rmi . server . Operation [] getOperations ( ) 

III 

yfH Class tcs.ain.infoserver.accessJnfoServerAccess_Stub 

^|>ublic final class Inf oServerAccess_Stub 

pfxtends: 

java.rmi.server.RemoteStub 
r| Implements: 

PI tcs. a i n. i nf oserver. access . i RemoteRepos itory 
java. rmi. Remote 

^Attributes 

interfaceHash 
operations 

Constructors 

I nf oServerAccess_Stub() 

lnfoServerAccess_Stub(java.rmi.server.RemoteRef) 

Operations 

addUserAgent(tcs.ain.infoserver.UserAgent) 

getQ uery Engi ne(j ava J a ng. Stri ng) 

getQueryEngines() 

getU serAgent(j ava Jang. String) 

getWorkerldsFromAgent(java.lang.String) 

isConnectedQ 

launchWorker(java.lang.String f java lang.String, java.utii.Hashtable) 
launchWorker(java. lang.String, java.lang.String) 



'bate Detail 



W: interfaceHash 

private static final long interfaceHash 
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• operations 

private static final java . rmi . server .Operation {] operations 



• InfoServerAccess_Stub 

public Inf oServerAccess_Stub ( ) 

© InfoServerAccess_Stub 

public Inf oServer Accesses tub (java. rmi. server. RemoteRef ) 



• addUserAgent 

public void addUserAgent {tcs . ain . inf oserver .UserAgent ) 

• getQueryEngine 

public tcs .ain. inf oserver .Que ryEngine getQueryEngine (java. lang . String) 

getQueryEngines 

vfpublic java.util .Hashtable getQueryEngines { ) 

M 

ftp getUserAgent 

yjpublic tcs. ain. inf oserver .UserAgent getUserAgent (java . lang. String) 

1 

yjl getWorkerldsFromAgent 

ftpublic java.util .Vector getWorkerldsFromAgent (java. lang. String) 

CP isConnected 

jTifpublic boolean isConnected ( ) 

!lf 

CP launchWorker 

public java. lang. St ring launchWorker (java. lang .String, java . lang. St ring, java.util .Hashtable) 

ft launchWorker 

public java. lang. String launchWorker (java . lang . String , java . lang . String) 



O Interface tcs.ain.infoserver.access.lRemoteRepository 

public interface IRemoteRepository 

Extends: 

java. rmi. Remote 

This interface provides access to user agents within the info Server. May be replaced by a Jini Service in the near future. 

Operations 

addUserAgent(UserAgent) 

getQueryEngi ne(Stri ng) 

getQueryEngines() 

getUserAgent(String) 

getWorkerldsFromAgent(Stnng) 

isConnected() 
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launch Worker(String, String, Hashtable) 
launch Worker(String, String) 



B: addUserAgent 

public abstract void addUserAgent (UserAgent ua) 

Throws: 

I nf oServerExcepti on 
RemoteException 

• getQueryEngine 

public abstract QueryEngine getQueryEngine (String id) 

Throws: 

ElementNotFoundException 
RemoteException 

getQueryEngines 

public abstract Hashtable getQueryEngines { ) 

Throws: 

Q RemoteException 

i 

%fk getUserAgent 

Sjpublic abstract UserAgent getUserAgent {String id) 

Ui 

w Throws: 

ElementNotFoundException 
^ RemoteException 

s getWorkerldsFrom Agent 

CI 

^public abstract Vector ge t Worker Ids FromAgent (String id) 

flf Throws: 

ft RemoteException 

5 

LH isConnected 

public abstract boolean isConnected ( ) 

Throws: 

ElementNotFoundException 
RemoteException 

• launchWorker 

public abstract String launchWorker (String id, String workerld, Hashtable htParams) 

Throws: 

I nf oServerExcepti on 
RemoteException 

• launchWorker 

public abstract String launchWorker {String id, String workerld) 

Throws: 

1 nf oServerException 
RemoteException 
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Package tcs.ain. infoserver. dest I 

■Hi Class Diagrams 
diagram dest 

Class Diagram dest 




I 



IPackage tcs.ain. infoserver. pqa 



h Class Diagrams 
diagram pqa 



ill 

s 

r:;B classes 

■ ■"" class tcs.ain. infoserver.pqa.LCDemoPublicDS 
^ class tcs.ain. infoserver. pqa. PQAEBook 
Q class tcs.ain. infoserver.pqa.PQALauncher 
pj class tcs.ain. infoserver. pqa. PQALogin 
class tcs.ain. infoserver.pqa.PQAMenu 
[5f class tcs.ain. infoserver. pqa. PQAPage 
p class tcs.ain. infoserver. pqa. PQAPagePrinter 
$?\ class tcs.ain. infoserver. pqa. PQAServletMain 
T[ class tcs.ain. infoserver.pqa.QNetPQAResource 

O interfaces 
i nterf ace tcs . a i n . i nf oserver. pqa . PQACon st 

Class Diagram oga 
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interface 
PQAConst 



+DEBUGMODE: boo lean 
+MENU PATH: String 
+LOGIN PATH: String 
+RESULT PATH : String 
+NOWORKERS PATH: String 



+NO RESULTS MSG: String 
+USERNAME: String 
+WORKERLIST : String 
+CANCEL: String 
+SECTI0N: String 
-HAUNCH: String 
+RESULTS TAG: String 
+USERNAME TAG: String 



+WORKERLIST TAG: String 

+WORKERID TAG: String 

+ INVALI DLOGIN TAG: String 



T 



LCDemoPublicDS 



+LCDemoPubiicDS 
+main:void 



WebPage Printer 
PQAPagePrinter 



+PQAPagePr inter 
-Hprint : void 



QNetPQAResource 



-resourceBundle:ResourceBundl 
+getBundle :ResourceBundle 
-initResourceBundle : vo id 
+getString: Stri ng 
+getlnt : i nt 



WebMain 
PQAServletMain 



#infoServerAccess : IRemoteRepo 
#j dbcConn : Connection 
+MainApp : Strin g 
#cursorLimit : i nt 
#cur sorCount : int 



+ PQAServletMain 
#loadSection : void 
+getWebPagePrinter :WebPagePri 
+getRMI Connection: IRemoteRepo 



+getDbConnection : Connectio n 
#cursorAvailable : boole an 
+releaseCursor : voi d 
#validateRMIConnection : vo id 
#makeRMIConnection:void 
#showRMIError : void 
#showDBError : void 
#validateDbConnection : vo id 
#makeDbConnect ion: void 



WebPage 



PQAPage 



#userName : String 



+ PQAPage 
+ PQAPage 

+getHtmlPage:StringBuff 
+replaceTags : String 




#HtmlPage : StringBuf f er 
#NoWor kersPage : StrmgBuf f e 



+GetPageId:in t 
+PQAMenu 
#getForm: String 
tfgetTagTable : Hashtable 
#getSelectBoxOptions : Strin 



body : String 



ttTAG: String 
#ATTRVAL: String 
#AGENT ID: String 
#W0RKER ID: String 
+LCRESULTS1 PATH: String 
#Html Page : StringBuf f er 
#worker!d : String 



+GetPageId:in t 

+PQAEBook 

#get Form: String 

#getTagTable : Hashtable 



body : String 




#HtmlPage : StringBuf f er 
#InvalidLoginMsg: String 



+GetPageId:in t 
+PQALogin 

•fProcessLogin: Strin g 
#QueryUserInfoDB: Result Se 
ttlsValidLogin: boole an 
#getForm: String 
#getTagTable : Hashtable 



body: St ring 



#HtmlPage : StringBuf f e 

#wor ker Id : String 

+GetPageId:in t 
+PQALauncher 
#get Form: String 
#getTagTable :Hashtabl 
body: String 
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Class Nodes 

tcs.ain.infoserver.pqa 
tcs.ain.infoserver.pqa 
tcs . a i n . i nf oserver. pqa 
tcs . a i n . i nf oserver. pqa 
tcs.ain.infoserver.pqa 
tcs.ain.infoserver.pqa 
tcs.ain.infoserver.pqa 
tcs.ain.infoserver.pqa 
tcs.ain.infoserver.pqa 

Interface Nodes 



LCDemoPublicDS 
PQAEBook 
PQALauncher 
PQALogin 
.PQAMenu 
PQAPage 
PQAPagePrinter 
PQAServletMain 
QNetPQAResource 



tcs.ain.infoserver.pqa.PQAConst 



KRI 



I Class tcs.ain.infoserver.pqa. LCDemoPublicDS 
Tests the iMAP Query Engine; query every one minute 

I Class tcs.ain.infoserver.pqa. PQAEBook 
Launch a DataWorker for a given Agent, and return results 

Extends: 

PQAPage 



to Class PQAPage 



63 Class tcs.ain.infoserver.pqa.PQALauncher 

Launch a DataWorker for a given Agent, and return results 

Extends: 

PQAPage 



to Class PQAPage 
1 Class tcs.ain.infoserver.pqa. PQALogin 

USER LOGIN PAGE. This prompts user for username/pw and tries and to find (or create) a UserAgent object for them. The UserAgent 
object is inserted into the user's Session under the name 'userAgent', for retention between screens This will eventually validate against 
and reference the SMS Internet Suite Userlnfo database. Note: New agents are created for authenticated users, and their WebProv values 
will be assigned to the agent for name, email, min We will need to keep the agent info up-to-date somehow. 

Extends: 

PQAPage 



General 



to Class PQAPage 



Class tcs.ain.infoserver.pqa. PQAMenu 

Return a Menu listing of all DataWorkers belonging to a given UserAgent. 



Extends: 

PQAPage 
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to Class POAPage 



1 Class tcs.ain.infoserver.pqa.PQAPage 
Launch a Data Worker for a given Agent, and return results 

Extends: 

WebPage 

Implements: 

PQAConst 

to Interface PQAConst 
1 Class tcs.ain.infoserver.pqa. PQAPagePrinter 

Base class for web page printing operations. Provides methods to print the header, banner, etc. Subclasses can provide distinct color / 
font / banner schemes for individual projects or pages 

Extends: 

WebPagePrinter 



,; ;lhd Class tcs.ain.infoserver.pqa.PQAServletMain 

j! This is the Main page for the QueryNet PQA Servlet. This loads pages according to the received Section variable 
Extends: 



WebMain 

Implements: 

PQAConst 



*i to Interface PQAConst 



Class tcs.ain.infoserver.pqa. QNetPQAResource 

This class is a singleton for a property resource bundle to be used by the QueryNet PQA Servlet. The resource bundle contains values 
that could potentially be displayed to users. It also provides a direct, static method for safely getting String values without worrying 
about MIssingResourceExceptions ras; 2/29/99; modified by S. Levine on 5/01/00 

& Interface tcs.ain.infoserver.pqa. PQAConst 

The Interface is a contains common constants which apply to the QueryNet PQA Interface, modified by S. Levine on 9/9/99 



s • ,.-,„: 



H Class tcs.ain.infoserver.pqa. LCDemoPublicDS 

public class LCDemoPublicDS 
Tests the I MAP Query Engine; query every one minute 
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Constructors 

LCDemoPublicDSO 

Operations 

main(StringO) 



m LCDemoPublicDS 

public LCDemoPublicDS ( } 

Throws: 

Exception 



• main 

public static void main (String [] args) 



B C\ass tcs.ain.infoserver.pqa.POAEBook 

fcfniblic class PQAEBook 

^Ixtends: 

tcs.ain.infoserver.pqa.PQAPage 

^Launch a DataWorker for a given Agent, and return results 



f^ttributes 

5; AGENTJD 

m ATTRVAL 

si Html Page 

n LCRESULTS1„PATH 

hV'TAG 

worker! d 
til WORKERJD 

pjbo/isfrucfors 

fT, PQAEBook(HttpServletRequest, HttpServletResponse, String) 

Operations 

getBody() 
getForm(String) 
GetPageid() 
getTagTa b le(Stri ng) 



Attribute Detail 
m AGENTJD 

protected static final String AGENT_ID = "rsmith" 
Agent ID 

& ATTRVAL 

protected static final String ATTRVAL = "SF_ATTRSTR" 
Attribute Value parameter name constant 

SI HtmiPage 

protected static StringBuffer HtmiPage = null 
Stores Htmi Page associated with a form producing class 
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m LCRESULTS1_PATH 

public static final String LCRSSULTS1__PATH « QNetPQAResource .getString ( "LCResultsl " ) 
Results Page Path 

• TAG 

protected static final String TAG = "SFJTAG" 
Tag parameter name constant 

• workerld 

protected String workerld = " " 

Stores Html Page associated with a form producing class 

• WORKER J D 

protected static final String WORKER_ID = "LC Operation Manual" 
WorkerlD 



m PQAEBook 

public PQAEBook (HttpServlet Request request, HttpServletResponse response, String userName) 
%j Constructor calls superQ and sets the title for this page 



ilFllI^^ 

fift getBody 

U. jjubl ic String g e t Body ( ) 

L get Login Body. Since the initial login form is stored on the pqa, this should only be called to retrieve an error login 
rti§ getForm 

^protected String getForm (String results) 

p| Create an html form for selecting or removing existing Data Workers. This is the initial form for the Query Net Wizard 
r % GetPageld 

public static int GetPageld {) 
• getTagTable 

protected Hashtable getTagTable (String results) 

Create a table of tags and their values to be used in replacing tags found in static html pages. Used to add dynamic content to these 
pages. 

H Class tcs.ain.infoserver.pqa.POALauncher 

public class PQALauncher 

Extends: 

tcs.ain.infoserver.pqa.PQAPage 

Launch a DataWorker for a given Agent, and return results 



Attributes 

Htm l Page 
workerld 
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Constructors 

PQALauncher(HttpServletRequest, HttpServletResponse, String) 

Operations 

getBody() 
getForm(String) 
GetPageld() 
getTagTable(String) 



nbute Detail 



m HtmlPage 

protected static StringBuffer HtmlPage = null 
Stores Html Page associated with a form producing class 

ft workerld 

protected String workerld = " " 

Stores Html Page associated with a form producing class 



*ji PQALauncher 

public PQALauncher (HttpServletRequest request, HttpServletResponse response, String userName) 
l! Constructor calls superQ and sets the title for this page 




Hon Detail 



III getBody 

^public String getBody () 

%i get Login Body. Since the initial login form is stored on the pqa, this should only be called to retrieve an error login 
j|i getForm 

protected String getForm {String results) 

S Create an html form for selecting or removing existing Data Workers. This is the initial form for the Query Net Wizard 

fll GetPageld 

public static int GetPageld () 
ft getTagTable 

protected Hashtable getTagTable (String results) 

Create a table of tags and their values to be used in replacing tags found in static html pages. Used to add dynamic content to these 
pages. 



H Class tcs.ain.infoserver.pqa.POALoBin 

public class PQALogin 

Extends: 

tcs.ain.infoserver.pqa.PQAPage 

USER LOGIN PAGE This prompts user for username/pw and tries and to find (or create) a UserAgent object for them. The UserAgent object 
is inserted into the user's Session under the name 'userAgent', for retention between screens This will eventually validate against and 
reference the SMS Internet Suite Userinfo database. Note: New agents are created for authenticated users, and their WebProv values will be 
assigned to the agent for name, email, min We will need to keep the agent info up-to-date somehow. 
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Attributes 

HtmlPage 
Invalid Login Msg 

Constructors 

PQALogin{H1tpServletRequest, HttpServletResponse) 

Operations 

getBody() 
getForm() 
GetPageldO 
getTagTabie() 

isValidLogin(ResuitSet, String) 
ProcessLogin(HttpServletRequest) 
QueryUseri nf oDB(Stri ng) 



m HtmlPage 

protected static StringBuffer HtmlPage = null 
Stores Html Page associated with a form producing class 

• InvalidLoginMsg 

protected static final String InvalidLoginMsg = QNetPQARe source .get St ring { "InvalidLoginMsg" ) 
# Stores Html Page associated with a form producing class 

!% PQALogin 

Jpublic PQALogin (HttpServletRequest request, HttpServletResponse response) 
«. Constructor calls super() and sets the title for this page 



CJj| getBody 



"public String getBody {) 

get Login Body. Since the initial login form is stored on the pqa, this should only be called to retrieve an error login 

• getForm 

protected String getForm () 

Create an html form for selecting or removing existing Data Workers. This is the initial form for the Query Net Wizard 

Wt GetPageld 

public static int GetPageldO 

• getTagTable 

protected Hashtable getTagTable { ) 

Create a table of tags and their values to be used in replacing tags found in static html pages. Used to add dynamic content to these 
pages. 

• IsValidLogin 

protected static boolean IsValidLogin (ResultSet r, String password) 
Autherticate the user. 
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• ProcessLogin 

public static String ProcessLogin (HttpServletRequest req) 

Validate a login, return username if valid log in, null if invalid. REMEMBER: users can log in with Alias or PIN so be sure 

» QueryUserlnfoDB 

protected static ResultSet QueryUserlnf oDB (String username) 
Query the UserProvisioning database for the login name 

B Class tcs.ain.infoserver.pqa.POAMenu 

public class PQAMenu 

Extends: 

tcs.ain.infoserver.pqa.PQAPage 

Return a Menu listing of all DataWorkers belonging to a given UserAgent 

Attributes 

Html Page 
NoWorkersPage 

Constructors 

PQAMenu(HttpServletRequest, HttpServletResponse, String) 

klpperations 

% 4 getBodyO 

f|! getForm(Vector) 

^5 GetPageldQ 

getSelectBoxOptions(Vector) 
4S getTagTable(Vector) 




Cfl HtmlPage 

fljbrotected static StringBuffer HtmlPage = null 
L5J Stores Html Page associated with a form producing class 

C5l NoWorkersPage 

^protected static StringBuffer NoWorkersPage = null 
Stores Html Page associated with a form producing class 



J> PQAMenu 

public PQAMenu (HttpServletRequest request, HttpServletResponse response, String userName) 
Constructor calls superQ 



mmm 



mm 



• getBody 

public String getBodyO 

get Menu Body. List all DataWorkers associated with a given agent 

• getForm 

protected String getForm (Vector workerList) 
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Create an html form for selecting or removing existing Data Workers. This is the initial form for the Query Net Wizard 

• GetPageld 

public static int GetPageld () 

• getSelectBoxOptions 

protected String getSelectBoxOptions (Vector workerList) 
Create a select box for the given parameter and select a specified value. * 

•f getTagTabie 

protected Hashtable getTagTabie (Vector workerList) 

Create a table of tags and their values to be used in replacing tags found in static html pages. Used to add dynamic content to 
pages. 

B Class tcs. a/n, infoserver. pqa. POAPa&e 

public abstract class PQAPage 

Extends: 

tcs.web.WebPage 

implements: 

p| tcs.ain.infoserver.pqa.PQAConst 

^||Launch a DataWorker for a given Agent, and return results 

%\ 'fi 

Attributes 

||| userName 

fponstructors 

55? PQAPage(HttpServletRequest, HttpServletResponse) 

IS! PQAPage(HttpServietRequest, HttpServletResponse, String) 

^Operations 

m getHtmlPage(String) 

replaceTags(String, Hashtable) 




userName 

protected String userName 



m PQAPage 

public PQAPage (HttpServletRequest request, HttpServletResponse response) 
Constructor calls super() and sets the title for this page 

m PQAPage 

public PQAPage (HttpServletRequest request, HttpServletResponse response, String userName) 
Constructor calls superQ and sets the title for this page 



# getHtmlPage 

public StringBuffer getHtmlPage (String path) 

Read in specified Html Page and store to static HtmiPage StringBuffer 
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Throws: 

Exception 

• replaceTags 

public String replaceTags (String content, Hashtable ht) 
Read in specified Html Page and store content to StringBuffer 

B Class tcs.ain.infoserver.pqa.PQAPagePrinter 

public class PQAPage Printer 

Extends: 

tcs.web.WebPagePrinter 

Base class for web page printing operations. Provides methods to print the header, banner, etc. Subclasses can provide distinct color / font 
/ banner schemes for individual projects or pages 

Constructors 

PQAPagePrinter(WebPage) 

Operations 

printQ 



^^^^^^^^^^^^^^^^^^^^^^ 



■^te PQAPagePr inter 

public PQAPagePrinter (WebPage page) 

ff; Construct the page printer object. This assings the owner and gets the output stream 
C$1 print 

llfmblic void print (} 

1*1 public print method; what client calls to start the printing process. This calls the basic components of the page (header, banner, body, 
*t«f footer) 

*' B Class tcs.ain.infoserver.pqa. PQAServletMain 

public class PQAServletMain 

Extends: 

tcs.web.WebMain 

Implements: 

tcs.ain.infoserver.pqa.PQAConst 
This is the Main page for the QueryNet PQA Serviet. This loads pages according to the received Section variable 

Attributes 

cursorCounl 

cursorLimit 

infoServerAccess 

jdbcConn 

MainApp 

Constructors 

PQAServletMainO 

Operations 

cursorAvaiiab!e() 
getDbConnectionQ 
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getRMlConnectionQ 
getWebPagePrinter(WebPage) 

loadSection(HttpServletRequest f HttpServletResponse) 
makeDbConnection() 
makeRMIConnection() 
releaseCursorQ 

showDBError(HttpServletResponse) 
showRMIError(HttpServletResponse) 
validateDbConnectionO 
validateRM IConnection() 

• cursorCount 

protected static int cursorCount = 0 
The database cursors currently open by repository. 

• cursorLimit 

protected static final int cursorLimit « QNetPQAResource .get Int ( "DbCursorLimit" ) 
The database cursor limit for the Repository database connection. 



• infoServer Access 

^protected static IRemoteRepository inf oServerAccess = null 

|| Remote InfoServer Access Repository for loading / saving User Agents and Sources. Accessed via RMI 

H| 

|fl jdbcConn 

^protected static Connection jdbcConn 

r ^ JDBC Connection for querying provisioning information from database 

J$l MainApp 

Ipublic static String MainApp = QNetPQAResource . gets t ring ( "MainAppPath" ) 




gpl PQAServletMain 

asjpubl ic PQAServletMain ( ) 




• cursorAvailable 

protected static boolean cursorAvailable ( ) 
Check to see if cursor limit has been reached 

• getDbConnection 

public static Connection getDbConnection ( ) 

Return a reference to jdbcConn if the CursorLimit has not been exceeded and a valid connection can be established, otherwise return null. 
This protects from exceeding the a given Database Implementation's cursor limit setting. It is the calling procedures responsibility to call 
re | ease cursor when finished using the jdbcConn reference. Throws exception if unable to establish a valid database connection 

Throws: 

SQLException 

ft getRMIConnection 

public static IRemoteRepository getRMIConnection ( ) 

Connect the remote object to the server if necessary and return RMI Connection 
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Throws: 

Exception 

• getWebPagePrinter 

public WebPagePrinter getWebPagePrinter {WebPage wp) 

Connect the remote object to the server if necessary and return RMI Connection 

Throws: 

Exception 

• loadSection 

protected void loadSection (HttpServlet Request request, HttpServletRespon.se response) 

Evaluate the 'Section' value and load the appropriate page. If Section is not set, then just load the MONTHVI EW_PAGE page 

ft makeDbConnection 

protected static void makeDbConnection ( ) 

Make sure jdbcConn is valid. If not, report the error to out and return false 

Throws: 

SQLException 

Pfl makeRMIConnection 

protected static void makeRMIConnection ( } 
21 Connect the remote object to the server if necessary 

HI Throws: 

fi Exception 

||l releaseCursor 

» public static void releaseCursor ( ) 

CI Decrement cursorCount so that another process may reference jdbcConn 
OP showDBError 

-S3' 

Q>rotected static void showDBError (HttpServletResponse response) 
H Display a spiffy RMI error message 

• showRMI Error 

protected static void showRMI Error (HttpServletResponse response) 
Display a spiffy RMI error message 

ft validateDbConnection 

protected static void validateDbConnection ( ) 

Make sure con is valid. If not, report the error to out and throw the exception 

Throws: 

SQLException 

ft validateRMlConnection 

protected static void validateRMlConnection { ) 

make connection if necessary; test the connection; if failed, try to to remake the connection return true if good connection 



H Class tcs.ain.infoserver.pqa.QNetPOAResource 

public class QNetPQARe source 



Page 252 of 332 



This class is a singleton for a property resource bundle to be used by the QueryNet PQA Serviet The resource bundle contains values that 
could potentially be displayed to users. It also provides a direct, static method for safely getting String values without worrying about 
MIssingResourceExceptions ras; 2/29/99; modified by S. Levine on 5/01/00 

Attributes 

resourceBundle 

Operations 

getBundle() 
getlnt(String) 
getString(String) 
initResourceBundleQ 




W: resourceBundle 

private static ResourceBundle resourceBundle = null 
The resource bundle we keep for use by the package. 




• getBundle 

^public static ResourceBundle getBundle () 

C§ Return the single, static instance of the resource bundle for the SMPP Module 

|{* getlnt 

"^public static int getlnt (String key) 

yj Pass through to the resourceBundle, except that we internally catch the MissingResourceException and report the error but return a T. 
fi\ Return tnt value. 

^ft getString 

^public static String getString (String key) 

5 

ttf Pass through to the resourceBundle, except that we internally catch the MissingResourceException and report the error but return a T 
51 il- initResourceBundle 

^private static void initResourceBundle ( } 
Create the resource bundle 



O Interface tcs.ain.infoserver.pqa.POAConst 

public interface PQAConst 

The Interface is a contains common constants which apply to the QueryNet PQA Interface, modified by S. Levine on 9/9/99 
Attributes 

CANCEL 

DEBUGMODE 

INVALi DLOG I N_TAG 

LAUNCH 

L0G!N_PATH 

MENU_PATH 

NOWORKERS_PATH 

NO_RESULTS_MSG 

RESULTS.TAG 

RESULTPATH 

SECTION 
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USERNAME 

USERNAME_TAG 

WORKERID.TAG 

WORKERLiST 

WORKERLIST_TAG 

Attribute Detail _ ilr. " 

ft CANCEL 

String CANCEL = " CANCEL " 
Form Cancel Button. 

ft DEBUGMODE 

boolean DEBUGMODE = Boolean. valueOf (QNetPQARe source .getString ( "DebugMode" )). booleanValue ( ) 
Specifies whether app is in debug mode 

ft I N VALI DLOGI N_TAG 

String INVALIDLOGIN_TAG = "<!-- INVALIDLOGINMSG -->" 

Form Tag that lets up put dynamic Invalid Login Message in static html 
ft LAUNCH 

Cfetring LAUNCH = "LAUNCH" 
™\ Form Launch Button. 

|l» LOG!N_PATH 

"Lktring LOGIN_PATH = QNetPQARe source .getString ( "LoginPath" ) 
b| Path to Login page 

jfW MENU.PATH 

string MENU_PATH = QNetPQAResource. getString {"MenuPath") 
III Path to Menu page 

NOWORKERS PATH 

glstring NOWORKERS_PATH = QNetPQAResource . getString ( "NoWorkersPath" > 

p f Path to No Workers page 
ft NO_RESULTS_MSG 

String NO_RESULTS_MSG = QNetPQAResource .getString ( "NoResultsMsg" ) 
No Results Returned from QueryNet Message 

ft RESULTS JTAG 

String RESULTS__TAG = "<!-- RESULTS -->" 

Form Tag that lets up put dynamic result information in static html 

ft RESULTJPATH 

String RESULT_PATH = QNetPQAResource . getString ( "ResultPath" ) 
Path to Results page 

ft SECTION 

String SECTION = "SECTION" 
Form Section id Hidden Field. 

ft USERNAME 
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String USERNAME = "USERNAME" 
Form Hidden Field containing a Userid 

Wt USERNAMEJTAG 

String US ERNAME__TAG = »<!-- USERNAME -->" 

Form Tag that lets up put dynamic UserName information in static html 

m WORKERID.TAG 

String WORKERI D_TAG = "<!-- WORKER ID -->" 

Form Tag that lets up put dynamic Workerld information in static html 

m WORKERLIST 

String WORKERLIST « "WORKERLIST" 
Form Listbox containing a list of worker ids. 

• WORKERLISTTAG 

String WORKERLI ST_TAG = "<!-- WORKERLIST -->" 

Form Tag that lets up put dynamic WorkerList ListBox in static html 



I Package tcs.ain. infoserver.servlet 



& Class Diagrams 

diagram servlet 



:fO Classes 

y 

class tcs.ain. 

class tcs.ain. 
If class tcs.ain. 
|| class tcs.ain. 
lis class tcs.ain. 
J;f class tcs.ain. 
1} class tcs.ain. 
J! class tcs.ain. 
^ class tcs.ain. 
B * class tcs.ain. 

class tcs.ain. 

class tcs.ain. 

class tcs.ain. 

class tcs.ain. 

class tcs.ain. 

class tcs.ain. 

class tcs.ain. 

class tcs.ain. 

class tcs.ain. 

class tcs.ain 

class tcs.ain, 

class tcs.ain 



infoserver. 
! nfoserver. 
infoserver. 
infoserver. 
infoserver. 
infoserver. 
infoserver. 
infoserver. 
infoserver. 
infoserver. 
infoserver. 
infoserver. 
infoserver. 
infoserver. 
infoserver. 
infoserver. 
infoserver, 
infoserver, 
infoserver, 
infoserver, 
infoserver, 
infoserver, 



servlet.AddEditServicesPage 
servlet.CreateNewSourceForm 
servlet.CustomSourceForm 
serviet.CustomizeAgentForm 
servlet. DataSourceForm 
servlet.DataWorkerForm 
servlet.DataWorkerWizardForm 
servlet. DestinationForm 
servletlSEIementCreatorException 
servlet.lSEIementLoader 
servlet. ISServietException 
servlet InfoSvrMain 
servlet. InfoSvrPage 
servlet. Login Page 
servlet.MainMenuPage 
servlet.PublicSourceForm 
servlet.QNServiceCreator 
servlet .Q N Servi etResou rce 
servlet.QNWebPagePrinter 
servlet.QueryNetResource 
servlet.StatusForm 
, servlet. ViewServicesPage 



O Interfaces 

interface tcs.ain.infoserver.servlet.lSEIementCreator 



Class Diagrams 



iiil 



Class Diagram servlet 
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Class Nodes 

tcs.ain.infoserver.servIet.AddEditServicesPage 

tcs.ain.infoserver.serviet.CreateNewSourceForm 

tcs.ain.infoserver.servlet.CustomizeAgentForm 

tcs.ain.infoserver.servletCustomSourceForm 

tcs.ain.infoserver.servlet.DataSourceForm 

tcs. a in . inf oserver. servl et. DataWorkerForm 

tcs.ain.infoserver.servlet.DataWorkerWizardForm 

tcs.ain.infoserverservletDestinationForm 

tcs.ain.tnfoserver.servietlnfoSvrMain 

tcs.ain.infoserver.servletlnfoSvrPage 

tcs.ain.infoserver.servlet.iSElementCreatorException 

tcs.ain.infoserver.servIetJSEIementLoader 

tcs.ain.infoserver.servletJSServlet Exception 

tcs.ain.infoserver.servlet.LoginPage 

tcs.ain.infoserver.servlet.MainMenuPage 

tcs.ain.infoserver.servletPublicSourceForm 

tcs.ain.infoserver.servlet.QNServiceCreator 

tcs.ainJnfoseiver.servlet.QNServletResource 

tcs.ain.infoserver.serviet.QNWebPagePrinter 

tcs.ain.infoserver.servlet.QueryNetResource 

tcs.ain.infoserver.serviet.StatusForm 

tcs. ain J nf oserver. serviet.ViewServicesPage 

Interface Nodes 

tcs. ain J nf oserver. servl et. t S El ementCreator 



I Class tcs.ain.infoserver.servlet.AddEditServicesPage 

Extends: 

infoSvrPage 

0e^^f/^mXttjff<s 
to Class InfoSvrPage 

I Class tcs.ain/mfoserver.servletCreateNewSourceForm 

Define the Data Sources that are desired. 

Extends: 

Data WorkerWiza rd Form 

to Class DataWorkerWizardForm 

J Class tcs.ain.infoserver.servletCustomizeAgentForm 
Define the Data Sources that are desired. 

Extends: 

DataWorkerWizardForm 



to Class DataWorkerWizardForm 
H Class tcs.ain.infoserver.servlet.CustomSourceForm 



Define the Data Sources that are desired. 
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Extends: 

DataWorkerWizardForm 



to Class DataWorkerWizardForm 
I Class tcs.ain.infoserver.servlet.DataSourceForm 

Extends: 

tcs.ain.infoserver.servlet.DataWorkerWizardForm 

to Class DataWorkerWizardForm 

I Class tcs.ain.infoserver.servletDataWorkerForm 
Define the Data Sources that are desired. 

Extends: 

DataWorkerWizardForm 



\| to Class DataWorkerWizardForm 

? fjfi Class tcs.ainJnfoserver.servIet.DataWorkerWizardForm 

yl Base class for elements that will show info about a DataWorker Subclasses will access each component that a DataWorker cares about 

lH Class tcs.ainJnfoserver.servlet.DestinationForm 
n i Define the Data Sources that are desired. 
$21 Extends: 

M DataWorkerWizardForm 



to Class DataWorkerWizardForm 
I Class tcs.ain.infoserver.servletlnfoSvrMain 

This is the Main page for the Info Server Web Application. This loads pages according to the received Section variable 

Extends: 

WebMain 

I Class tcs.ain.infoserver.servletlnfoSvrPage 

Extends: 

WebPage 



I Class tcs.ain.infoserver.servlet.lSEIementCreatorException 

Extends: 

ISServletException 
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to Class ISServietException 



Class tcs.ain.infoserver.servletlSEIementLoader 

to Interface ISEiementCreator 

Class tcs. ain.infoserver. servlet ISServietException 

Extends: 

Exception 

Class tcs.ain.infoserver.servlet.LoginPage 

USER LOGIN PAGE. This prompts user for username/pw and tries and to find (or create) a UserAgent object for them. The UserAgent 
object is inserted into the user's Session under the name 'userAgent', for retention between screens This will eventually validate against 
and reference the SMS Internet Suite Userlnfo database. Note: New agents are created for authenticated users, and their WebProv values 
will be assigned to the agent for name, email, min We will need to keep the agent info up-to-date somehow. 

Extends: 

InfoSvrPage 

to Class InfoSvrPage 

Class tcs.ain.infoserver.servlet.MainMenuPage 

MAIN MENU PAGE. This will provide the main options for the app. 

Extends: 

InfoSvrPage 

to Class InfoSvrPage 

I Class tcs.ain.infoserver.servlet.PublicSourceForm 
Define the Data Sources that are desired. 

Extends: 

DataWorkerWizardForm 



to Class DataWorkerWizardForm 

I Class tcs.ain.infoserver.servlet.QNServiceCreator 
S. Levineon 11/1/99 

Implements: 

ISEiementCreator 



to Interface ISEiementCreator 



Page 259 of 332 



Class tcs.ain. infoserver.servlet QNServietResource 

This class is a singleton for a property resource bundle to be used by the Query Net Wizard. The resource bundle contains values that 
could potentially displayed to users. It also provides a direct, static method for safely getting String values without worrying about 
MlssingResourceExceptions ras; 2/29/99; modified by S. Levine on 9/9/99 

Class tcs.ain. infoserver.servlet QNWebPagePrinter 

Extends: 

tcs.web.WebPagePrinter 



C I a ss tcs. ain . infoserver. sen/let QueryNetResource 

This class is a singleton for a property resource bundle to be used by the Query Net Wizard. The resource bundle contains values that 
could potentially displayed to users. It also provides a direct, static method for safety getting String values without worrying about 
MlssingResourceExceptions ras; 2/29/99; modified by S. Levine on 9/9/99 



H Class tcs.ain. infoserver.servlet.StatusForm 
Define the Data Sources that are desired. 

Extends: 

DataWorkerWizardForm 



Zi to Class DataWorkerWizardForm 

■a* 



j'Q Class tcs.ain. infoserver.servletViewServicesPage 

w 

Extends: 

J InfoSvrPage 



!(PBera0|§fflbii /tote 



III 

fli to Class InfoSvrPage 

■ci ^ ^ ^ ^ ^ ^ ^ ^ 

& Interface tcs.ain.infoserver.servletlSEIementCreator 



B Class tcs.ain. infoserver. servletAddEditServicesPaze 

public class AddEditServicesPage 
Extends: 

tcs.ain. infoserver.servletlnfoSvrPage 

Attributes 

access 

action 

agent 

step 

stepList 

testld 
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Constructors 

AddEditServicesPage(HttpServletRequest, HttpServletResponse, iRemoteRepository, UserAgent) 

Operations 

cleanUpSession() 

doCustAgentStep() 

doCustSourceStep() 

doDestStepO 

dolntroStepO 

doNewSourceStepO 

doPubIicSourceStep() 

doSelectWorkerStep() 

getBodyO 

GetPageldO 

processWizardForm(DataWorkerWizardForm, boolean, boolean) 
sync$tepList(Vector, String) 



• access 

protected IRemoteRepository access 

ft action 

protected String action 
lift agent 

^protected UserAgent agent 

f 

|jft step 

"protected String step = null 

* ,# ft stepList 

^protected Vector stepList 



ft testld 



^protected String testld 



^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ 



B AddEditServicesPage 

public AddEditServicesPage (HttpServletRequest request, HttpServletResponse response, 
IRemoteRepository access, UserAgent agent) 

Constructor calls super() and sets the title for this page 



Hi cleanUpSession 

protected void cleanUpSession ( ) 

• doCustAgentStep 

protected void doCustAgentStep ( ) 



ft doCustSourceStep 

protected void doCustSourceStep ( ) 
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• doDestStep 

protected void doDestStepO 

ft doIntroStep 

protected void doIntroStep { ) 

• doNewSourceStep 

protected void doNewSourceStep ( ) 

• doPublicSourceStep 

protected void doPublicSourceStep ( ) 

ft doSelectWorkerStep 

protected void doSelectWorkerStep ( ) 

• getBody 

public String getBody () 

Return the page's body. For increased efficiency, this directly writes to the response output and does not actually return any data, 
ft GetPageld 

public static int GetPageld () 

;itl processWizardForm 

protected String processWizardForm { Da taWorkerWizardForm wizardForm, boolean doProcess, boolean 
^koPrint) 

WSI syncStepList 

protected void syncStepList (Vector list, String currStep) 

pi. Return the page's body. For increased efficiency, this directly writes to the response output and does not actually return any data. 

WB Class tcs.ain.infoserver.servlet.CreateNewSourceForm 

Q 

■Spublic class CreateNewSourceForm 
I^xtends: 

tcs.ain.infoserver.servlet.DataWorkerWizardForm 
Define the Data Sources that are desired. 

Attributes 

debug 
Htm I Page 
request 
testid 

Constructors 

CreateNewSourceForm(HttpServ!etRequest, iRemoteRepository, String) 

Operations 

getCustomSou rce(Stri ng f Stri ngBuff er) 

get Form () 

getSourceO 

getTagTable() 

populateForm FromWorker() 

populateWorkerFromForm() 

printCustomForm(String) 

processCustomSource(StringBuffer) 

setDebug(boolean) 
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if debug 

private boolean debug = true 
For Internal Debugging 

• HtmlPage 

protected static StringBuffer HtmlPage 

Stores Html Page associated with a form producing class 

• request 

protected HttpServletRequest request 
HttpServlet Request 

• testld 

protected String testld 

Stores error messages recieved from creating a new source 



jji CreateNewSourceForm 

^public CreateNewSourceForm (HttpServletRequest request, IRemoteRepository access, String stepDesc) 



Constructor 
;ll getCustomSource 

^protected QueryEngine getCustomSource (String source, StringBuffer errorMsg) 
0 Get a new Custom DataSource from the ISEIementCreator Implementation 

*jP getForm 

^public String getForm () 

Return the appropriate form for adding new workers or selecting existing workers 

$1 getSource 

protected String getSource () 

get selected source name from request object 

9t getTagTable 

protected Hashtable getTagTable ( ) 

Create a table of tags and their values to be used in replacing tags found in static html pages. Used to add dynamic content to these 
pages. 

• populateFormFromWorker 

protected void populateFormFromWorker ( ) 

Populate the form fields with values from the DataWorker 

• popuIateWorkerFromForm 

public String popuIateWorkerFromForm ( ) 

Populate the DataWorker with data assigned to the form 
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• printCustomForm 

protected String printCustomForm (String source) 

9t processCustomSource 

protected void processCustomSource (StringBuffer errorMsg) 
Handle logic flow of creating a new custom datasource 

9 setDebug 

public void setDebug (boolean b) 

Return the appropriate form for adding new workers or selecting existing workers 



B Class tcs.ain.infoserver.servlet Custom izeAzentForm 

public class Custom! zeAgent Form 
Extends: 

tcs.ain.infoserver.serviet.DataWorkerWizardForm 
Define the Data Sources that are desired. 

Attributes 

desc 
O dom 
•J\ domlndex 

domTable 
^J: dow 
yj dowlndex 
HI dowTable 
f* hour 

hourlndex 
m hourTable 
||| Htm I Page 
J ' minute 

minutelndex 
M minuteTable 
III newld 
ill testld 

Constructors 

Q CustomizeAgentForm(HttpServletRequest, IRemoteRepository, String) 

Operations 

addTimerValues(String[], Hashtable, TimeElement) 
createDomlndex() 
createDomTableO 
createDowlndex() 
createDowTabieQ 
createHourindex() 
createHourTable() 
create! ndex(Vector, String) 
createMinutelndex() 
createMinuteTabieQ 
getForm() 
getTagTable() 

popu lateForm FromWorker() 

populateWorkerFromFormO 
saveToRepositoryO 
setAgentPropeties() 
setCustomTimerO 

writeSelectBox(String p Hashtable, Vector, TimeElement) 



• desc 



Page 264 of 332 

protected String desc 

I dom 

protected String [} dom 

II domlndex 

protected static Vector domlndex - null 

■f domTable 

protected static Hashtable domTable = null 

• dow 

protected String [ 3 dow 

H dowlndex 

protected static Vector dowlndex = null 

• dowTable 

protected static Hashtable dowTable = null 
fjl hour 

^protected String [] hour 

hourlndex 

||jhrotected static Vector hourlndex = null 

|JJI hourTable 

Ilprotected static Hashtable hourTable = null 
CP Htm I Page 

Ilprotected static StringBuffer HtmlPage 

|3 Stores Html Page associated with a form producing class 

Ml minute 

r protected String [] minute 

• minutelndex 

protected static Vector minutelndex = null 
Wt minuteTable 

protected static Hashtable minuteTable = null 

• newld 

protected String newld 

• testld 

protected String testld 




H CustomizeAgentForm 

public CustomizeAgentForm (HttpServletRequest request, IRemoteRepository access, String stepDes 
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Constructor 

Operation Detail 
9t addTimerValues 

protected void addTimerValues (String [] timerValues, Hashtable table, TimeElement timeElement) 

• createDomlndex 

protected static void createDomlndex () 

• createDomTable 

protected static void createDomTable ( } 

Create a table to hold Day of Month options to be displayed to user as well as the corresponding TimeElement values 

• createDowlndex 

protected static void createDowlndex ( ) 

H createDowTable 

protected static void createDowTable (} 

Create a table to hold Day of Week options to be displayed to user as well as the corresponding TimeElement values 

createHourlndex 

protected static void createHourlndex ( } 

Ml© createHourTabie 

/^protected static void createHourTabie ( } 

m Create a table to hold Hout options to be displayed to user as well as the corresponding TimeElement values 



createlndex 

:ic void createlndex (Vector ^ 

/create vector list of possible index value for the specified index from the specified 



Sjprotected static void createlndex (Vector vlndex, String property) 



f^l /resource string. 

f J<i createMinutelndex 

protected static void createMinutelndex ( ) 

• createMinuteTable 

protected static void createMinuteTable ( ) 

Create a table to hold Minute options to be displayed to user as wei! as the corresponding TimeElement values 

O getForm 

public String getFormO 

Return the appropriate form for adding new workers or selecting existing workers 

• getTagTable 

protected Hashtable getTagTable { ) 

Create a table of tags and their values to be used in replacing tags found in static html pages. Used to add dynamic content to these 
pages. 

• populateFormFromWorker 

protected void populateFormFromWorker ( ) 

Populate the form fields with values from the DataWorker 
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•f populateWorkerFromForm 

public String populateWorkerFromForm () 

Populate the DataWorker with data assigned to the form 

• saveToRepository 

public void saveToRepository { ) 

• setAgentPropeties 

protected void setAgentPropeties ( ) 

• setCustomTimer 

protected String setCustomTimer ( } 

ft writeSelectBox 

protected String writeSelectBox (String name, 
timeElement) 



Hashtable table, Vector index, TimeElement 



B Class tcs.ain.infoserver.servlet CustomSourceForm 

public class CustomSourceForm 



"Define the Data Sources that are desired. 



^Extends: 

-4l tcs.ain.infoserver.serviet.DataWorkerWizardForm 

Mr 

m 

^kttributes 

HtmlPage 
iM request 

ffl 

"Constructors 

J?% CustomSourceFormCHttpServletRequest, IRemoteRepository r String) 

fWperations 

nl getAvailableDSO 

Q get Form () 

r*v getTagTabte() 

f =f populateFormFromWorkerO 

H popuiateWorkerFromFormQ 



■i 



• HtmlPage 

protected static StringBuffer HtmlPage 

Stores Htm! Page associated with a form producing class 

if- request 

protected HttpServletRequest request 



Cons 



7tor 



il 



en 



• CustomSourceForm 

public CustomSourceForm (HttpServletRequest request, IRemoteRepository access, String stepDes 
Constructor 
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• getAvailableDS 

protected String getAvailableDS C } 

create select box for available datasources and store in buffer 

• getForm 

public String getForm {) 

Return the appropriate form for adding new workers or selecting existing workers 

• getTagTable 

protected Hashtable getTagTable ( ) 

Create a table of tags and their values to be used in replacing tags found in static html pages. Used to add dynamic content to these 
pages. 

• populateFormFromWorker 

protected void populateFormFromWorker ( ) 

Populate the form fields with values from the DataWorker 

• populateWorkerFromForm 

^public String populateWorkerFromForm ( ) 

In 

Edit Data Worker based on user request 

Ott_ 

Class tcs.ain.infoserver.serviet DataSourceForm 

^public class DataSourceForm 

yfcxtends: 

in? I 

tcs.ain.infoserver.servlet.DataWorkerWizardForm 

^Attributes 

fil request 

fl! 

f^ponstructors 

r| DataSourceForm(javax.servlet.http.HttpServletRequest t tcs.ainJnfoserver.accessJRemoteRepository, java.lang. String) 

^Operations 

getAvailabieDSO 
getForm() 

parseComment(java.lang. String) 

parseDataSource(java.lang.String) 

populateFormFromWorkerO 

populateWorkerFromForm() 

processDataSourceQ 



H request 

protected javax. servlet .http .HttpServletRequest request 

DataSourceForm 

public DataSourceForm (javax. servlet . http . HttpServletRequest , 
tcs .ain. inf oserver . access . IRemoteRepository , java . lang . String) 
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• getAvailableDS 

protected void getAvailableDS ( ) 

• getForm 

public java. lang.String getForm () 

• parseComment 

protected j ava . lang . String parseComment (j ava . lang . String) 

• parseDataSource 

protected java. lang. String parseDataSource (java. lang. String) 

• populateFormFromWorker 

protected void populateFormFromWorker ( ) 

• populateWorkerFromForm 

public java. lang. String populateWorkerFromForm () 

processDataSource 

yHpublic void processDataSource ( ) 

8; 



Ufa Class tcs. ain.infoserver. servlet. Data WorkerForm 

>s|5public class DataWorkerForm 
Wfextends: 

Ui tcs.ain.infoserver. servlet. DataWorkerWizardForm 

1, Define the Data Sources that are desired. 

D 

^Attributes 

yj HtmlPage 
EI selectWorker 

p testld 
^Constructors 

DataWorkerForm(HttpServletRequest, IRemoteRepository, String) 

Operations 

getForm() 

getTagTable() 

getWorkerOptionsO 

getWorkersForm() 

popu lateForm FromWorkerO 

popu lateWorkerFrom FormQ 



• HtmlPage 

protected static StringBuffer HtmlPage 

Stores Html Page associated with a form producing class 

• selectWorker 

protected String selectWorker 
Name of Selected worker to be edited 
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m testld 

protected String testld 
Id to be used for script testing only 




1 DataWorkerForm 

public DataWorkerForm (HttpServletRequest request, IRemoteRepository access, String stepDesc) 
Constructor 




• getForm 

public String getForm {) 

Return the appropriate form for adding new workers or selecting existing workers 

• getTagTable 

protected Hashtable getTagTable ( ) 

ri Create a table of tags and their values to be used in replacing tags found in static html pages. Used to add dynamic content to these 
pages. 

j II getWorkerOptions 

protected String getWorkerOptions ( ) 

W i 

fP getWorkersForm 

^protected void getWorkersForm { ) 

3r Create an html form for selecting or removing existing Data Workers. This is the initial form for the Query Net Wizard 
populateFormFromWorker 

flprotected void populateFormFromWorker { ) 

15 Populate the form fields with values from the DataWorker 

yH populateWorkerFromForm 

public String populateWorkerFromForm { ) 

Populate the DataWorker with data assigned to the form 

B Class tcs. ain. infoserver.serviet Data WorkerWizardForm 

public abstract class DataWorkerWizardForm 

Base class for elements that will show info about a DataWorker Subclasses will access each component that a DataWorker cares about 

Attributes 

action 
agent 
buffer 

errorMessage 

repository 

session 

testld 

worker 

Constructors 

DataWorkerWizardForm(HttpServletRequest, IRemoteRepository, String) 
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Operations 

getForm() 

getHtmlPage(String) 
popuiateFormFromWorkerO 
populateWorkerFrom Form() 
printJava$cript() 
replaceTags(String, Hashtable) 




• action 

protected String action 

• agent 

protected UserAgent agent 

• buffer 

protected StringBuffer buffer 

• errorMessage 

protected String errorMessage = " " 
Ml repository 

^protected IRemoteRepository repository 

HP session 

^protected HttpSession session 

jp testid 

^protected String testid 
Q Used for testing scripts only 

worker 

fJj>rotected DataWorker worker 




SI DataWorkerWizardForm 

public DataWorkerWizardForm(HttpServletRequest request, IRemoteRepository r, String errorMessage) 
Constructor 




fl getForm 

public abstract String getForm () 
Return the HTML string that defines the form 

• getHtmlPage 

public StringBuffer getHtmlPage (String path) 

Read in specified Html Page and store to static HtmiPage StringBuffer 

Throws: 

Exception 
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• popuIateFormFromWorker 

protected abstract void popuIateFormFromWorker ( ) 
Populate the form fields with values from the DataWorker 

• populateWorkerFromForm 

public abstract String populateWorkerFromForm ( ) 
Populate the DataWorker with data assigned to the form 

printJavaScript 

public String print JavaScript { ) 

java script lor create pop up browser for displaying help info 

• repiaceTags 

public String repiaceTags (String content, Hashtable ht) 
Read in specified Html Page and store content to StringBuffer 

Throws: 

Exception 

B Class tcs. ain.infoserver. servlet Destination Form 

XX* Sj ' — — 

Jpublic class DestinationForm 
% Extends: 

gy tcs.ai n. inf oserver.servlet. DataWorkerWizardForm 
111 Define the Data Sources that are desired. 

tXlAttributes 

131 bNotifyChangeOnly 

^ dataSource 

f=s% destStore 

Jf! HtmlPage 

ill request 

ft] testld 

^Constructors 

M Destination Form(HttpServletRequest, IRemoteRepository, String) 

Operations 

addDestina1ion(String, IDataEventSource) 

addToList() 

getDestination(String) 

getForm() 

getTagTableO 

initList() 

populateFor m FromWorker() 

popuiateWorkerFromFormO 

printAvailDestListO 

printCurrDestListQ 

printNotifyChangeBox() 

printRequiredfnfo(String) 

printStyles(String) 

printStyleSectionQ 

proces sA ! way s N ot ify() 

processDestinationsO 

processNotifyChangeOnlyO 

removeDestinations(IDataEventSource) 

removeFromListQ 
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• bNotifyChangeOnly 

protected boolean bNotifyChangeOnly = false 

• dataSource 

protected QueryEngine dataSource = null 

• destStore 

protected Vector destStore = null 

• Htm I Page 

protected static StringBuffer HtmlPage 

Stores Html Page associated with a form producing class 

• request 

protected HttpServletRequest request = null 

» testld 

protected String testld = null 

DestinationFortn 

Xpublic DestinationForm (HttpServletRequest request, IRemoteRepository access, String stepDesc) 
Ut Constructor 



f lH addDestination 

^Jjbrotected String addDestination (String destination, IDataEvent Source iDes) 
Add a destination to Data Worker 

^i* addToList 

public void addToList () 

Add new destinations to destStore Vector and store into session obj 

getDestination 

protected UserDeliveryDestination getDestination (String destld} 
Return requested destination. 

$ getForm 

public String getForm () 

Return the appropriate form for adding new workers or selecting existing workers 

& getTagTable 

protected Hashtable getTagTable ( ) 

Create a table of tags and their values to be used m replacing tags found in static html pages. Used to add dynamic content to these 
pages. 
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9 initLtst 

protected void initListO 
initialize destStore 

• populateFormFromWorker 

protected void populateFormFromWorker ( } 

Populate the form fields with values from the DataWorker 

• popuIateWorkerFromForm 

public String popuIateWorkerFromForm ( ) 

Populate the DataWorker with data assigned to the form, or temporarily store. 

9 printAvailDestList 

protected String printAvailDestList ( ) 

Create an htmi Select box and populate with available destinations 

• printCurrDestList 

protected String printCurrDestList { ) 

Create an html Select box and populate with currently selected destinations 

%pt printNotifyChangeBox 

^protected String printNotifyChangeBox { ) 

Bl Create an html CheckBox for "Notify If Change Only" option 

U S 

j|i printRequiredlnfo 

L&jprotected String printRequiredlnfo (String destid} 
Create a text box and prompt for required info for a given destination 

CP printStyles 

^protected String printStyles (String destid) 

^ Create and populate a drop down box with available style options for a give data sources 
?4SI printStyleSection 

"protected String printStyleSection ( ) 

Create table rows dynamically based on Data Source info 

ft processAlwaysNotify 

protected String processAlwaysNotif y ( ) 
Add all destinations to Data Worker 

SI processDestinations 

public String processDestinations ( ) 
process selected destinations * 

• processNotifyChangeOnly 

protected String processNotif yChangeOnly ( ) 

Add destinations to NotifyChangeOnlyDesti nation, then add NotifyChangeOnlyDestination to Worker 

• removeDestinations 

protected void removeDestinations (IDataEventSource des) 
Remove destination from Data Worker 
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• removeFromUst 

public void removeFromList ( ) 

Remove selected destinations from destStore Vector 



H Class tcs. ain.infoserver.servlet InfoSvrMain 

public class InfoSvrMain 

Extends: 

tcs.web.WebMain 

This is the Main page for the info Server Web Application. This loads pages according to the received Section variable 

Attributes 

CrsrLoglntrv 

cursorCount 

cursorLimit 

infoServerAccess 

jdbcConn 

MainApp 

sessions 

Constructors 

InfoSvrMainO 

Operations 

cursorAvailableQ 

'SI getDbConnection() 

g\ getRMiConnectionQ 

l»- getSessionObj(Object) 

m getWebPagePrinter(WebPage) 

*p loadSection(HttpServletRequest, HttpServletResponse) 

|s| makeDbConnection() 
makeRMIConnection() 

^ putSessionObj(Object, Object) 

& releaseCursor() 

Q removeSessionObj(Object) 

S§ showDBError(HttpServietResponse) 

■J? showRM i Error(HttpServletResponse) 

IU validateDbConnectionO 

O va!idateRMIConnection() 




• CrsrLoglntrv 

protected static final int CrsrLoglntrv = QNServlet Re source .getlnt { "DbCursorLoglntrv" 
Amount of tries for a cursor to do before sending "WAITING FOR CURSOR" log message to stdout 

• cursorCount 

protected static int cursorCount = 0 
The database cursors currently open by repository. 

• cursorLimit 

protected static final int cursorLimit = QNServletResource . getlnt ( "DbCursorLimit " ) 
The database cursor limit for the Repository database connection. 

H infoServerAccess 

protected static IRemoteRepository infoServerAccess = null 

Remote InfoServer Access Repository for loading / saving User Agents and Sources. Accessed via RMI 

• jdbcConn 
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protected static Connection jdbcConn 

JDBC Connection for querying provisioning information from database 

• MainApp 

public static String MainApp = QKFServletRe source .gets t ring ( "MainAppPath" ) 

• sessions 

private static Hashtable sessions 

used for script load testing where regular session objects are not available 



Constructor Detail 



• InfoSvrMain 

public InfoSvrMain (} 

• cursorAvailable 

protected static boolean cursorAvailable ( ) 
Q Check to see if cursor limit has been reached 

Cll getDbConnection 

|||)ublic static Connection getDbConnection ( ) 

U I Return a relerence to jdbcConn if the CursorLimit has not been exceeded and a valid connection can be established, otherwise return null. 
*|* This protects from exceeding the a given Database implementation's cursor limit setting. It is the calling procedures responsibility to call 
1 5 1 release cursor when finished using the jdbcConn reference. Throws exception if unable to establish a valid database connection 

|5f Throws: 

% SQLException 

HP getRWIIConnection 

lybublic static IRemoteRepository getRMI Connect ion ( ) 

J% Connect the remote object to the server if necessary and return RMI Connection 

yi Throws: 

Exception 

• getSessionObj 

public static Object getSessionObj (Object key) 
Use this instead of session object when script testing 

• getWebPagePrinter 

public WebPagePrinter getWebPagePrinter (WebPage wp) 

Connect the remote object to the server if necessary and return RMI Connection 

Throws: 

Exception 

• loadSection 

protected void loadSection (HttpServletRequest request, HttpServletResponse response) 

Evaluate the 'Section' value and load the appropriate page. If Section is not set, then just load the MONTHVIEW_PAGE page 
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• makeDbConnection 

protected static void makeDbConnection { ) 

Make sure jdbcConn is valid. If not, report the error to out and return false 

Throws: 

SQLException 

# makeRMIConnection 

protected static void makeRMIConnection ( ) 
Connect the remote object to the server if necessary 

Throws: 

Exception 

ft putSessionObj 

public static void putSessionObj {Object key, Object value) 
Use this instead of session object when script testing 

ft releaseCursor 

public static void releaseCursor ( ) 

Decrement cursorCount so that another process may reference jdbcConn 

dM. removeSessionObj 

public static Object removeSessionObj (Object key) 
fn Use this instead of session object when script testing 

4ll showDBError 

^'protected static void showDBError {HttpServletResponse response) 
g. Display a spiffy RMI error message 

Sfi showRMIError 

fjprotected static void showRMIError (HttpServletResponse response) 

Cl Display a spiffy RMI error message 

Pi 

ft validateDbConnection 

protected static void validateDbConnection{) 

Make sure con is valid. If not report the error to out and throw the exception 

Throws: 

SQLException 

ft validateRMIConnection 

protected static void validateRMIConnection ( ) 

make connection if necessary; test the connection; if failed, try to to remake the connection return true if good connection 

B Class tcs. ain.infoserver. servlet InfoSvrPage 

public abstract class InfoSvrPage 

Extends: 

tcs.web.WebPage 

Attributes 

user Agent 
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Constructors 

lnfoSvrPage(HttpServletRequest, HttpServietResponse, UserAgent) 

Operations 

getHtmlPage(String) 
replaceTags(String f Hashtabie) 



^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ 



• userAgent 

protected UserAgent userAgent 



* InfoSvrPage 

public InfoSvrPage {HttpServletRequest req, HttpServletResponse res, UserAgent agent) 
Stores Html Page associated with a form producing class 

p fl getHtmlPage 

^public StringBuffer getHtmlPage (String path) 
M Read in specified Html Page and store to static HtmlPage StringBuffer 

^■J Throws: 

% zl Exception 

Jjfi replaceTags 

"public String replaceTags (String content, Hashtabie ht) 
Q Read in specified Htm! Page and store content to StringBuffer 

[Jf Throws: 

i II Exception 



IB Class tcs.ainJnfoserver.servIet ISElementCreatorException 

public class ISElementCreatorException 
Extends: 

tcs.ain.infoserver.servlet.lSServietException 

Constructors 

ISEIementCreatorException(String) 

Constructor Detail 

• ISElementCreatorException 

public ISElementCreatorException (String s) 



H Class tcs.ain.infoserver. servlet ISEIementLoader 

public class ISEIementLoader 

Attributes 

creator 
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resourceBundie 

Operations 

getBundle() 
getCreator() 
initResourceBundle() 

9t creator 

protected static ISElementCreator creator = null 

* resourceBundie 

protected static ResourceBundie resourceBundie = null 



9 getBundle 

private static ResourceBundie getBundle () 

Return the single, static instance of the resource bundle for the SMPP Module 

r# getCreator 

yCpublic static ISElementCreator getCreator () 

m Throws: 

Zll ClassNotFoundException 

InstantiationException 
£ lllegalAccess Except ion 

W 

OM initResourceBundle 

& private static void initResourceBundle ( ) 

ft 

r; Create the resource bundle 

ry 
fit 

f*|Bl Class tcs. ain.infoserver.servlet. ISServletException 

public class ISServletException 

! Extends: 

java.iang. Exception 

Constructors 

ISServletException(String) 



• ISServletException 

public ISServletException (String s) 

B Class tcs. ain. infoserver.servlet. Login Page 

public class LoginPage 
Extends: 

tcs.ain. i nf oserver. servlet. i nf oSvrPage 

USER LOGIN PAGE. This prompts user for username/pw and tries and to find (or create) a UserAgent object for them. The UserAgent object 
is inserted into the user's Session under the name 'userAgenf, for retention between screens This will eventually validate against and 
reference the SMS internet Suite Userlnfo database. Note: New agents are created for authenticated users, and their WebProv values will be 
assigned to the agent for name, email, mm We will need to keep the agent info up-to-date somehow. 
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Attributes 

access 
Htm I Page 
password 
testid 
username 

Constructors 

LoginPage(HttpServletRequest, HttpServletResponse, IRemoteRepository) 

Operations 

createNewAgent(ResultSet) 

getBody() 

getinvalidLogin() 

getLoginFormQ 

GetPageld() 

isValidLogin(ResuitSet) 

printO 

process Login() 
queryUserlnfoDBO 
syncAgent(ResultSet r UserAgent) 

access 

gjprotected IRemoteRepository access 
How we obtain Agents 

Si 

jjjfll Htm I Page 

IJ protected static StringBuffer HtmlPage 
J ^ Stores Html Page associated with a form producing class 

password 

^protected String password 

Di» testid 

I'll 

^protected String testid 

f • username 

protected String username 




• LoginPage 

public LoginPage (HttpServletRequest request, HttpServletResponse response, IRemoteRepository 
access) 

Constructor calls superQ and sets the title for this page 



SI createNewAgent 

protected UserAgent createNewAgent (ResultSet r) 

Create a new UserAgent based on information we can get from the UserProvisioning database for the iogin name 

• getBody 

public String getBody ( ) 



■ ::== 

■111 



Page 280 of 332 

Return the page's body 
ft getlnvalidLogin 

protected String getlnvalidLogin { ) 

Return String describing that the login/pw were invalid 

• getLoginForm 

protected String getLoginForm ( ) 

Show the login form. When accepted, this page will get called again, but then it will process the results 

ft Get Page Id 

public static int GetPageldO 
ft isValidLogin 

protected boolean isValidLogin (ResultSet r) 
Autherticate the user. 

ft print 

public void print {) 

Ensure that pagePrint is set to not print banner 

Sjft processLogin 

-^protected String processLogin ( ) 

4l process the login; if acceptable, stick in the Session and show Welcome Page 
J'ft queryUserlnfoDB 

^protected ResultSet queryUserlnfoDB ( } 

Query the UserProvisioning database for the login name 

flft syncAgent 

% r, 

protected void syncAgent (ResultSet r, UserAgent agent) 
Make sure agent info is up to date with provisioning information. 

? B Class tcs. ain.infoserver.servlet MainMenuPage 

public class MainMenuPage 
Extends: 

tcs.ain. infoserver.serviet. Inf oSvrPage 
MAIN MENU PAGE. This will provide the main options for the app. 

Attributes 

HtmlPage 
SiteVec 

Constructors 

MainMenuPage(HttpServietRequest, HttpServletResponse, UserAgent) 

Operations 

getBody() 

getPageDescription() 
GetPageldO 
getSiteVec() 
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Attribute Detail 

• HtmlPage 

protected static StringBuffer HtmlPage 

Stores Html Page associated with a form producing class 

# SiteVec 

protected static Vector SiteVec = new Vector {) 

This contains a central list of the site account names. Referenced elsewhere, but just populated here 



trDetett 



ft MainMenuPage 

public MainMenuPage (HttpServletRequest request, HttpServletResponse response, UserAgent agent) 
Constructor calls super() and sets the title for this page 

• getBody 

ppublic String getBody () 
yff the page body 

fjj* getPageDescription 

|f|>ublic String getPageDescription ( ) 
Jf * This returns the special page description. 

gfl GetPageld 

-public static int GetPageld () 

fill getSiteVec 

public static Vector getSiteVec{) 
pv Return the static vector of available sites 

B Class fcs, ain.infoserver.servlet PublicSourceForm 

public class PublicSourceForm 
Extends: 

tcs.ain.infoserver.servlet.DataWorkerWizardForm 
Define the Data Sources that are desired. 



Attributes 

HtmlPage 

request 

testid 

Constructors 

PublicSourceForm(HttpServletRequest, IRemoteRepository, String) 

Operations 

getAvailableDS() 

getFormO 

getTagTable() 

parseDataSource(String) 

populateFormFromWorker() 
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populateWorkerFromFormO 
processDataSource() 

• HtmlPage 

protected static StringBuffer HtmlPage 

Stores Htmi Page associated with a form producing class 

ft request 

protected HttpServlet Request request 
Request object 

• testld 

protected String testld 
Used for testing via scripts only 



• PublicSourceForm 

public PublicSourceForm (HttpServletRequest request, IRemoteRepository access, String stepDesc) 
> : Constructor 



tlQltt 



getAvailableDS 

flfprotected String getAvailableDS ( } 

create select box for available datasources and store in buffer 

if * s 

!U9t getForm 

^public String getForm () 

5l Return the appropriate form for adding new workers or selecting existing workers 
getTagTable 

protected Hashtable getTagTable ( ) 

Create a table of tags and their values to be used in replacing tags found in static html pages. Used to add dynamic content to these 
pages. 

• parseDataSource 

protected String parseDataSource (String source) 

Remove comment from destination. Comment is delimited with in front, ex./ parseDestinationfEMAIL: This is a public email 
destination.") returns "EMAIL" 

• populateFormFromWorker 

protected void populateFormFromWorker ( ) 

Populate the form fields with values from the DataWorker 

■f populateWorkerFromForm 

public String populateWorkerFromFormO 
Edit Data Worker based on user request 



Page 283 of 332 



& processDataSource 

public void processDataSource { ) 
Edit Data Worker based on user request 



H Class tcs. ain. infoserver. servlet ONServiceCreator 

public class QNServiceCreator 

Implements: 

tcs.ain.infoserver.servlet.lSElementCreator 

S. Levine on 11/1/99 



Attributes 

customSourcesDb 
debug 

destinationsDb 

STARTREF 

URL 

Constructors 

QNServiceCreatorQ 

Operations 

p| getAttribute(String, String, int) 

■JI getAttribute(String, String) 

%l getAttribute(String, int, String) 

Si getChatDestination(String, Vector, StringBuffer) 

Hi getCustEmailSourceForm(String, InfoServerElement, UserAgent) 

^ getCustomEmaiiSource(String, HttpServletRequest, StringBuffer) 

HI getCustomSource(String, HttpServletRequest, StringBuffer) 

4i getCustomWebSource(String, HttpServletRequest, StringBuffer) 

Ul getCustWebSourceForm(String, InfoServerElement, UserAgent) 

J5J getDestination(String, Vector, StringBuffer) 

getElementNames(int, boolean) 
£ getEmailDestination(String, Vector, StringBuffer) 
P getFormatStyle(UserDeliveryDestination) 

1 getFormatter(QueryEngine f String) 
l»l getMinFromField(String, String) 
flj getReqChatDestlnfo(lnfoServerElement, UserAgent) 
p| getReqEmailDestlnfo(lnfoServerElement, UserAgent) 
5i getReqEmailSourcelnfo(lnfoServerElement, UserAgent) 
W getReqSMSDestlnfo(lnfoServerElement, UserAgent) 
M getRequiredData(String, InfoServerElement, UserAgent, int) 

getRequirements(String, int) 

getSimpleDestination(String, StringBuffer) 

getSMSDestination(String, Vector, StringBuffer) 

getStyles(String, int) 

getSubForm(String, InfoServerElement, UserAgent, int) 

isValidHostName(String) 

loadElemen1s(String, String) 

rateReliability(String) 

return DbType(int) 

validMin(String) 

<§ customSourcesDb 

private Hashtable customSourcesDb = null 
Store custom source elements. 

• debug 

private static final boolean debug = true 
For Internal Debugging 
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• destinationsDb 

private Hashtable destinationsDb = null 
Store Destination elements. 

ft STARTREF 

private static final String STARTREF = QNConst . EDT_PREFIX + " STARTREF " 
Name of uri field Create Web Source Form 

ft URL 

private static final String URL = QNConst . EDT_PRE FIX + "URL" 
Name of url field Create Web Source Form 



mam 



# QNServiceCreator 

public QNServiceCreator () 

Return the single, static instance of the resource bundle for the SMPP Module 

ttfft getAttribute 

^protected String getAttribute (String name, String attr, int elementType) 

Si 

III Return the attribute from an Element Config String given the element name, attribute, and elementType. 

4** getAttribute 

III 

^protected String getAttribute {String conf igString, String atName) 
$ Return the attribute from an Element Config String given the string, and the attribute. 

Sift getAttribute 

.fljjprivate Vector getAttribute (String name, int elementType, String attr) 
|3 Return Parsed Attribute String, and return elements in a vector 

o 

getChatDestination 

private ChatUserDestination getChatDestination (String destination, Vector reqlnfo, StringBuffer 
errorMsg) 

Load elements descriptions from resource file into hashtabies 

• getCustEmailSourceForm 

protected String getCustEmailSourceForm (String name, Inf oServerElement element, UserAgent agent) 
Get form components necessary in creating the specifed element 

ft getCustomEmailSource 

"private NewEmailQueryEngine getCustomEmailSource (String source, HttpServletRequest request, 
StringBuffer errorMsg) 

Load elements descriptions from resource file into hashtabies 
ft getCustomSource 

public QueryEngine getCustomSource (String source, HttpServletRequest request, StringBuffer 
errorMsg) 

Load elements descriptions from resource file into hashtabies 
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• getCustomWebSource 

private QueryEngine getCustomWebSource (String source, HttpServletRequest request, StringBuffer 
errorMsg} 

Load elements descriptions from resource file into hashtabfes 

• getCustWebSourceForm 

protected String getCustWebSourceForm (String name, InfoServerElement element, UserAgent agent) 
Get form components necessary in creating a web datasource 

• getDestination 

public UserDeliveryDestination getDestination {String destination, Vector reqlnfo, StringBuffer 
errorMsg) 

Load elements descriptions from resource file into hashtables 

• getElementNames 

public Vector getElementNames {int elementType, boolean addDesc) 
return list of elements descriptions from specified hashtable 

• getEmailDestination 

private EmailUserDestination getEmailDestination (String destination, Vector reqlnfo, StringBuffer 
errorMsg) 

Load elements descriptions from resource file into hashtables 
getFormatStyle 

y public String getFormatStyle (UserDeliveryDestination dest) 
4* Return the name of the XSL format being used by this destination 

fljfl getFormatter 

-public DataFormatter getFormatter (QueryEngine ds, String style) 
Load elements descriptions from resource file into hashtables 

fill getMinFromField 

fef rotected strin 9 getMinFromField (String value, String srchFld) 

CI try t0 l00ku P and return the MIN from tne Userlnfo table using the recvd search field returns null if not found 

• getReqChatDestlnfo 

protected Vector getReqChatDestlnfo (InfoServerElement element, UserAgent agent) 

• getReqEmailDestlnfo 

protected Vector getReqEmailDestlnfo (InfoServerElement element, UserAgent agent) 

• getReqEmailSourcelnfo 

protected Vector getReqEmailSourcelnfo (InfoServerElement element, UserAgent agent) 

• getReqSMSDestlnfo 

protected Vector getReqSMSDestlnfo (InfoServerElement element, UserAgent agent) 

• getRequiredData 

public Vector getRequiredData (String destld, InfoServerElement element, UserAgent agent, int 
elementType) 

Return existing Required Data associated with an existing element 
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• getRequirements 

public Vector getRequirements {String name, int elementType) 
Return Required Information necessary for creating an element of this type 

• getSimpleDestination 

private SimpleUserDestination getSimpleDestination (String destination, StringBuffer errorMsg) 
Create a Simple user destination 

ft getSMSDestination 

private SMSUserDestination getSMSDestination (String destination, Vector reqlnfo, StringBuffer 
errorMsg) 

Load elements descriptions from resource file into hashtables 
ft getStyles 

protected Vector getStyles (String name, int elementType) 
Return Required information necessary for creating an element of this type 

ft getSubForm 

public String getSubForm (String name, Inf oServerElement element, UserAgent agent, int elementType) 
Get form components necessary in creating the specifed element 

lift isValidHostName 

"^protected boolean isValidHostName (String host) 

Check to see if host name is valid. Return True if valid False if invalid. 

**ft loadElements 

public void loadElements (String sourceElements, String destElements) 

Load elements descriptions into hashtables, this method should only ever be called once by the loader so no need to synchronize. 

^ft rateReliability 

^protected String rateReliability (String key} 

! Relate reliability of Xml parsing key based on a scale of 1-10 were l=most reliable and 10=least reliable. The less tags in the key, the 
j more reliable. 4 tags or less is a 1, and every tag after that adds 1 to the rating. For ex./ Clip.Html[0].Body[0].Table[0] is very reliable 
and would be a 1, and Clip.Html[0].Body[0].Table[2].TR[l].TD[2] would be less reliable(but still reasonably reliable) and would be a 3 

ft returnDbType 

protected Hashtable returnDbType (int elementType) 
Return correct hashtable dependent on elementType 

ftvalidMin 

protected boolean validMin (String address) 

Look at the msgMIN field to ensure that it really contains a MIN. It is possible that it could actually contain alternate addressing info 
which must be translated to a MIN address. 

B Class tcs.ain.infoserver.servletONServletResource 

public class QNServletResource 

This class is a singleton for a property resource bundle to be used by the Query Net Wizard. The resource bundle contains values that could 
potentially displayed to users. It also provides a direct, static method for safely getting String values without worrying about 
MIssingResourceExceptions ras; 2/29/99; modified by S. Levine on 9/9/99 



Attributes 

resourceBundle 
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Operations 

getBundle() 
getint(String) 
getString(String) 
initResourceBundieQ 



• resourceBundle 

private static ResourceBundle resourceBundle = null 
The resource bundle we keep for use by the package. 



.:=:..:.'.=■;.:.....:. -.- 



» getBundle 

public static ResourceBundle getBundleO 

Return the single, static instance of the resource bundle for the SMPP Module 

m getlnt 

public static int getlnt (String key) 

m . Pass through to the resourceBundle, except that we internally catch the MissingResourceException and report the error but return a 
H Return Int value. 

getString 

Mfpublic static String getString (String key) 

Pass through to the resourceBundle, except that we internally catch the MissingResourceException and report the error but return a 

WWI initResourceBundle 

m 



private static void initResourceBundle ( ) 
Cl Create the resource bundle 

i 

Jjjfi Class tcs.ain. infoserver.servlet. ONWebPasePrinter 

ppublic class QNWebPage Printer 

MExtends: 

tcs.web.WebPagePrinter 

Constructors 

QNWebPagePrinter(tcs.web.WebPage) 

Operations 

printQ 



,ctor Detail 
m QNWebPagePrinter 

public QNWebPagePrinter (tcs . web . WebPage ) 



• print 

public void print ( ) 
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H Class tcs.ain.infoserver.servletOuervNetResource 

class QueryNetResource 

This class is a singleton for a property resource bundle to be used by the Query Net Wizard. The resource bundle contains values that could 
potentially displayed to users. It also provides a direct, static method for safely getting String values without worrying about 
MIssingResourceExceptions ras; 2/29/99; modified by S. Levine on 9/9/99 

Attributes 

resourceBundie 

Operations 

getBundle() 

getString(String) 

initResourceBundleQ 

• resourceBundie 

private static ResourceBundie resourceBundie = null 
The resource bundle we keep for use by the package. 



getBundie 

%Jpublic static ResourceBundie getBundie () 

m 

^ Return the single, static instance of the resource bundle for the SMPP Module 

|» getString 

public static String getString (String key) 

g " Pass through to the resourceBundie, except that we internally catch the MissingResourceException and report the error but return a "?" 
rti initResourceBundle 

tJjprivate static void initResourceBundle ( ) 
P! Create the resource bundle 



*9 Class t cs. a in. infoserver. servlet Status Form 

public class StatusForm 
Extends: 

tcs.ain.infoserver.serviet.DataWorkerWizardForm 
Define the Data Sources that are desired. 

Attributes 

HtmlPage 
testld 

Constructors 

StatusForm(HttpServietRequest f IRemoteRepository, String) 

Operations 

getDestinations() 

getForm() 

getTagTable() 

populateFormFromWorkerO 
populateWorkerFromFormQ 
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• Htm! Page 

protected static StringBuffer HtmlPage 

Stores Html Page associated with a form producing class 

m testld 

protected String testld 

id to be used for script testing only 

Constructor Detail 

• StatusForm 

public StatusForm (HttpServletRequest request, IRemoteRepository access, String stepDesc) 
Constructor 



• getDestinations 

Ujprotected String getDestinations ( ) 

Return destinations associated with dataworker in html tag IMPORTANT: 1.) ONLY FILTERS WILL HAVE CHILD LISTENERS 2.) CHILD 
"M LISTENERS CAN BE OTHER FILTERS OR DESTINATIONS 3.) CHILD LISTENERS WILL NOT HAVE SIBLINGS 4.) DESTINATIONS WILL NOT 
m HAVE CHILD LISTENERS ex/ ChangeOnlyFilter | SearchFilter | | | SMS Dest. Email Dest. Chat Dest. 

getForm 

I s public String getForm {) 

ttl Return the appropriate form for adding new workers or selecting existing workers 
g|l getTagTable 

ffjbrotected Hashtable getTagTable { ) 

Jjif Create a table of tags and their values to be used in replacing tags found in static html pages. Used to add dynamic content to these 
M pages. 

|Ji populateFormFromWorker 

protected void populateFormFromWorker { ) 

Populate the form fields with values from the DataWorker 

• populateWorkerFromForm 

public String populateWorkerFromForm ( } 

Populate the DataWorker with data assigned to the form 



Class tcs.ain.infoserver.servlet.ViewServicesPage 



public class ViewServicesPage 
Extends: 

tcs.ain . t nf oserver. servlet I nf oSvrPage 



Attributes 

HtmlPage 

Constructors 

ViewServicesPage(HttpServletRequest, HttpServletResponse, UserAgent) 
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Operations 

getBodyO 

getDestinations(DataWorker) 

GetPageldO 
getTagTabie() 

processFormData(HttpServletRequest) 
showServiceListQ 



• Htm I Page 

protected static StringBuffer HtmlPage 

Stores Html Page associated with a form producing class 



• ViewServicesPage 

public ViewServicesPage (HttpServletRequest request, HttpServletResponse response, UserAgent agent) 
Constructor calls superQ and sets the title tor this page 



ftp getBody 

^public String getBodyO 

||| Return the page's body. For increased efficiency, this directly writes to the response output and does not actually return any data. 

I s ; p getDestinations 

protected String getDestinations (DataWorker worker) 

s- Return destinations associated with dataworker in html tag IMPORTANT: 1.) ONLY FILTERS WILL HAVE CHILD LISTENERS 2.) CHILD 
Hi LISTENERS CAN BE OTHER FILTERS OR DESTINATIONS 3.) CHILD LISTENERS WILL NOT HAVE SIBLINGS 4.) DESTINATIONS WILL NOT 
SI: HAVE CHILD LISTENERS ex/ ChangeOnlyFiiter | SearchFilter | | | SMS Dest. Email Dest Chat Dest. 

[jjl GetPageld 

Spublic static int GetPageldO 

"I* getTagTable 

protected Hashtable getTagTable { ) 

Create a table of tags and their values to be used in replacing tags found in static html pages. Used to add dynamic content to these 
pages. 

• processFormData 

public void processFormData {HttpServletRequest request) 
Start and stop workers based on user input 

ft showServiceList 

protected String showServiceList ( ) 

Create a table and show a summary of each of the services (ie, Workers owned by the userAgent. The worker titles will also contain 
hyperlins for more information and editing choices 
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O Interface tcs. ain.infoserver. servlet ISEIementCreator 

public interface ISEIementCreator 



Attributes 

CLASS 

CUSTOMSOURCE_ET 
DELIMIT 
DESCRIPTION 
DESTINATIONS 
FORMATTER 
NAME 
REQUIRED 
STYLES 

Operations 

getCustomSource(String, HttpServletRequest, StringBuffer) 
getDestination(String, Vector, StringBuffer) 
getElementNames(int, boolean) 
getFormatStyle(UserDeliveryDesti nation) 
getFormatter(QueryEngine, String) 

getRequiredData(String, InfoServerElement, UserAgent, int) 

getRequirements(String, int) 
««i getSubForm(String, InfoServerElement, UserAgent, int) 
U loadElements(String, String) 

Up CLASS 

String CLASS = "CLASS" 
*ffk Element Attribute 

zjt CUSTOMSOURCE_ET 

tint CUSTOMSOURCE ET = 0 
fl| Element Type 

^DELIMIT 

^String DELIMIT = "~" 
String Delimiter 

• DESCRIPTION 

String DESCRIPTION = "DESC" 

Element Attribute 

• DESTINATION_ET 

int DESTINATION^ = 1 
Element Type 

• FORMATTER 

String FORMATTER = " FORMATTER" 
Element Attribute 

• NAME 

String NAME = "NAME" 
Element Attribute 
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m REQUIRED 

String REQUIRED = "REQUIRED " 
Element Attribute 

m STYLES 

String STYLES = "STYLES" 
Element Attribute 



• getCustomSource 

public abstract QueryEngine getCustomSource (String source, HttpServletRequest request, StringBuffer 
errorMsg) 

• getDestination 

public abstract UserDeliveryDestination getDestination (String destination, Vector reqlnfo, 
StringBuffer errorMsg) 

9t getElementNames 

public abstract Vector getElementNames (int elementType, boolean addDesc) 
*JP getFormatStyle 

^P ublic abstract String getFormatStyle (UserDeliveryDestination dest) 

1,4. t' 

till getFormatter 

^public abstract DataFormatter getFormatter (QueryEngine ds, String style) 

^Sl getRequiredData 

^public abstract Vector getRequiredData (String destld, Inf oServerElement element, UserAgent agent, 
yint elementType) 

If* ^ 

Hi! getRequirements 

public abstract Vector getRequirements (String name, int elementType) 

fe* getSubForm 

public abstract String getSubForm (String name, Inf oServerElement element, UserAgent agent, int 
elementType) 

• loadElements 

public abstract void loadElements (String sourceElements , String destElements) 
Load elements descriptions into hashtabies 



Packaze tcs.ainjnfoserver.simpleweb 



h Class Diagrams 
diagram simpleweb 

i Classes 

class tcs.ain.infoserver.simpieweb.CustomEmailSourceGenerator 
class tcs.ain.infoserver.simpieweb.CustomWebSourceFormGenerator 
class tcs.ain.infoserver.simpleweb.CustomWebSourceGenerator 
class tcs.ain.infoserver.simpieweb.lnvalidParameterException 
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class tcs.ain.infoserver.simpieweb.JspBean 
class tcs.ain.infoserver.simpleweb.PublicAgentListGenerator 
class tcs.ain.infoserver.simpleweb.UserWorkFormGenerator 
class tcs.ain.infoserversimpleweb.UserWorkForm Processor 



Class Diagram simpleweb 



Q 

m 
%i 

m 
in 
j: 
w 
m 



iii 
ni 
o 
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Cus tonWebSourceGenerator 

+SaveButtonId: Stri ng 
returnJsp: String 



+CustomWebSourceGenerator 
+getForntForDataWorker: String 
+getNewFormHtml : String 
#getFormHtml : String 
+getPageParserQueryEngineFrom 
#getPageParserQueryEngine : Pag 
#isValidLabel : boolean 
#getConf idencel con : String 



UserWorkFormGenerator 

+WorkerFld: Strin g 

+IsRunmnaFId: Stri ng 

#inf oServerAccess : IRemoteRepo 

#agentWorkers : DataWorker [ ] 

#userData : UserData 

# user Agent :UserAgent 



-HJserWorkFormGenerator 
+getForms : String [ ] 
#getIsRunningField: StringBuf f 
#getChangeOnlyField: StringBuf 
#getTimerFields : StringBuf fer 
#getDestination£ields: StringB 
#DoesSourceHaveEmailListener : 



DoesSourceHaveSmsListener : boo 



Us erWorkFo rmProces sor 

#inf oServerAccess : IRemoteRepo 
#userData:UserData 
#userAgent : UserAgent 
#dataWorker : DataWorker 
request : HttpServletRequest 



+UserWorkFormProcessor 
+processForm: boolean 
#applyl sRunning : void 
#applyTimerFields:void 
#getWorkerChangeOnlyFilter :Ch 
#applyChangeOnly : void 
#applyDestinationFields:void 
#removeEmail Support : void 
# remove SmsSupport : void 
tfaddEmail Support : void 
iaddSms Support : void 



Exceptio 

InvalidParamaterException 



+InvalidParameterExcepti 



Cus tomEmail SourceGenerator 



+createEmailQueryEngine:NewEm 
#isValidMailHost: boolean 



java. lang.Obje 
PublicAgentLis tGenerator 



#infoServerAccess : tcs . ain . inf 
iagentWorkers : tcs . ain . inf oser 
iuserData : tcs . ain . appdata .Use 
#userAgent : tcs .ain. infoserver 



+PublicAgentLis tGenerator 



forms: java. lang. String [ ] 



java. lang.Obje 
CustoroWebSourceFortnGenerator 



+SaveButtonId: java. lang . St rin 
returnJsp : j ava . lang . String 



+CustomWebSourceFormGenerator 
+getPageParserQueryEngineFrom 
#get FormHtml : java . lang . String 
+getFormForDataWorker: java. la 
+ getNewFormHtml : j ava . lang . Str 
getPaqeParserQuervEngine : tcs . 



JspBean 



UserAgentld: Stri ng 
UserDatald: Strin g 
+ChangeWorkerButtonId : Strin g 
+DeleteWorkerButtonId: Str ing 
+createPublicWorkerButtonId: S 



#inf oServerAccess : IRemoteRepo 

#userDb:SMSAppDB 

# j dbcConn : Connection 

#dbCheckSql : String 



+ JspBean 
+logout : void 
+login: boolean 
-f-isSystemAvailable : boolean 
+isValidSession: boolean 
+getUserData: UserData 
+processCustomWorkerCreateReq 
+processPublicWorkerCreateReq 
+getCreatePublicWorkerForm:St 
+getWorkerCount : int 
+processWorkerChangeRequest : b 
-t-getAgentWorkerEditForms : Stri 
#getUserAgent : UserAgent 
tvalidateRMIConnection : boolea 
imakeRMIConnection : void 
#makeDbConnection : void 
#validateDbConnection : void 
+ShouldWorkerOuervAlwa ys : bool 



+main: void 



systemAvailable : boolean 
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Class Nodes 

tcs.ain.infoserver.simpleweb.CustomEmailSourceGenerator 

tcs.ainjnfoserver.simpleweb.CustomWebSourceFormGenerator 

tcs.ain.infoserver.simpieweb.CustomWebSourceGenerator 

tcs.ainJnfoserver.simpleweb.invalidParameterException 

tcs.ain.infoserver.simpleweb.JspBean 

tcs.ain.infoserver.simpleweb.PublicAgentListGenerator 

tcs.ain.infoserver.simpleweb.UserWorkFormGenerator 

tcs.ainJnfoserver.simpieweb.UserWorkFormProcessor 

B Class tcs.ainjnfosetver.simpleweb.CustomEmailSourceGenerator 
This class is used to generated a customer Email Source 

B Class tcs.ainMoseiver.simpleweb.CustomWebSourceFormGenerator 

Extends: 

java.lang.Object 

B Class tcs.ainJnfoseiver.simpleweb.CustomWebSourceGenerator 
C! This presents all of the Public Data Sources and provides relevant information for any UserAgents that reference the public sources 

Nfi Class tcs.ainJnfosewer.simplewebJnvalidParameterException 

pf! This can be thrown whenever a JSP passes parameters to an object and the parameters are missing, invalid, etc. 

'is* 

4 ? Extends: 

W Exception 

pJB Class tcs.ain.infoserver.simpleweb.JspBean 

111 This provides some methods to simplify access to QNet and also return some dynamic HTML content. 

Ill 

yH Class tcs.ainJnfoserver.simpleweb.PublicAgentListGenerator 

M. Extends: 

java.lang.Object 

B Class tcs.ain/infoserver.simpleweb.UserWorkFormGenerator 

This presents all of the Public Data Sources and provides relevant information for any UserAgents that reference the public sources TO 
DO: Remove hard-coded English in the form use more constants for field ids 

H Class tcs.ainJnfoseiver.simpleweb.UserWorkFormProcessor 

This guy applies change requests for a worker against the useragent, which is obtained by querying the session 

B Class tcs.ainjnfoserver.simpleweb.CustomEmailSourceGenerator 

public class CustomEmailSourceGenerator 
This class is used to generated a customer Email Source 
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Operations 

createEmailQueryEngine(String, String, String) 
isValidMailHost(String) 




■BHHHHI 




• createEmailQueryEngine 

public NewEmailQueryEngine createEmailQueryEngine (String hostName, String userld, String password) 

Based on the parameters received from the request, attempt to create a NewEmailQueryEngine object. Throw an Exception with 
description of the problem if there is one. TO DO: DNS Validation, as with servlet, Remove Hard-Coded names 

Throws: 

InvalidParameterException 
java.net.UnknownHostException 

m isValidMailHost 

protected boolean isValidMailHost (String hostname) 
Do the DNS MX lookup to determine if this host is valid or not 

B Class tcs.ainJnfoseiver.simpleweb. CustomWebSourceFormGenerator 

^.public class CustomWebSourceFormGenerator 



f$\ttributes 

"?i return J sp 
^! SaveButtonld 

l 8 E 

ffftonstructors 

$ CustomWebSourceFormGenerator(java.lang.String) 
^Operations 

yi getFormForDataWorker(tcs.ainJnfoserver.DataWorker) 

til getFormHtmf(java.util.Hashtable, java Jang. String, java.lang. String) 

Q getNewFormHtml(java.lang.String f java Jang. String) 

Hi getPageParserQueryEngine(tcs.ainJnfoserver.DataWorker) 

f"f getPageParserQueryEngineFromForm(javax.servlet.http.HttpServietRequest) 



.ffxtends: 

CI java.lang.Object 




• returnJsp 



Java . lang . String returnJsp 



Wt SaveButtonld 



public static java . lang . String SaveButtonld 




• CustomWebSourceFormGenerator 



publ ic CustomWebSourceFormGenerator ( j ava . lang . String ) 





• getFormForDataWorker 

public java . lang . String getFormForDataWorker ( tcs . ain . inf oserver . DataWorker) 
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• getFormHtml 

protected java . lang . String getFormHtml {java.util .Hasht able, java. lang. String, java.lang. String) 

• getNewFormHtml 

public java. lang. String getNewFormHtml (java. lang. St ring, java. lang. String) 

• getPageParserQueryEngine 

static tcs . ain . inf oserver . PageParserQueryEngine 
getPageParserQueryEngine { tcs . ain . inf oserver . DataWorker ) 

• getPageParserQueryEngineFromForm 

public tcs . ain . inf oserver . PageParserQueryEngine 

getPageParserQueryEngineFromForm ( j avax . servlet . http . HttpServletRequest ) 

B Class tcs.ainjnfoseiver.simpleweb.CustomWebSourceGenerator 

public class CustomWebSourceGenerator 

This presents all of the Public Data Sources and provides relevant information for any UserAgents that reference the public sources 

Attributes 

ri return J sp 
SaveButtonld 

%Ponstructors 

Of CustomWebSourceGenerator(String) 

Operations 

getConfidencelcon(int) 

H getFormForDataWorker(DataWorker, String) 

R| getFormHtml(HashtabIe, String, String, String) 

*» getNewFormHtml(String, String, String) 

pi getPageParserQueryEngine(DataWorker) 

M getPageParserQueryEngmeFromForm(HttpServletRequest) 

Rl isValidLabel(String) 




String return Jsp 

• SaveButtonld 

public static String SaveButtonld = "save" 



• CustomWebSourceGenerator 

public CustomWebSourceGenerator (String returnJsp) 
Called from the JspBean when user wants forms representing workers 

• getConfidencelcon 

protected String getConfidencelcon (int level) 
Return a representation of the confidence, based on the number. 
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• getFormForData Worker 

public String getFormForDataWorker {DataWorker worker, String tableHeader) 

Show the data selection form, but based on the PageParserQE already contained by this worker This is useful when/ if we want to edit an 
existing Web QueryEngine 

Throws: 

Exception 

• getFormHtml 

protected String getFormHtml (Hashtabl e currentSelectedl terns , String href, String startText, String 
tableHeader) 

Generate the form for selecting data from the href, setup the field to checked if currentSeiectedltems contains the field already throw an 
exception if the site can not be accessed TO DO: it would be really great to sort entries by confidence level! 

Throws: 

Exception 

• getNewFormHtml 

public String getNewFormHtml (String href, String startText, String tableHeader) 

show a new form for selecting content startText can be null or 0 length if not relevant includes a 'saveform' submit button at the end. 

Throws: 

p% Exception 

getPageParserQueryEngine 

r||protected PageParserQueryEngine getPageParserQueryEngine (DataWorker worker) 
y ! Return a PageParserQueryEngine if associated with this data source, return null if none found 

getPageParserQueryEngineFromForm 

!!|>ublic PageParserQueryEngine getPageParserQueryEngineFromForm(HttpServletRequest request) 

Create and return a PageParserQueryEngine based on the form variables. 
n I Throws: 

fll InvalidParameterException 

y? java.netUnknownHostException 

j% isValidLabel 

protected boolean isValidLabel (String label) 
Does this consist of a-z or A-Z? 

B Class tcs.ain.infoserver.simpleweb. InvalidParameterException 

public class InvalidParameterException 

Extends: 

java.lang.Exception 

This can be thrown whenever a JSP passes parameters to an object and the parameters are missing, invalid, etc. 

Constructors 

I nva I idParameterException(String) 

• InvalidParameterException 

public InvalidParameterException (String s) 
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H Class tcs.ain.infoserver.simplewebJspBean 

public class JspBean 

This provides some methods to simplify access to QNet and also return some dynamic HTML content. 

Attributes 

ChangeWorkerButton I d 

CreatePublicWorkerButtonld 

dbCheckSql 

DeleteWorkerButtonld 

infoServerAccess 

jdbcConn 

UserAgentld 

UserDatald 

userDb 

Constructors 

JspBean() 

Operations 

getAgentWorkerEditForms(HttpSession, String) 

getCreatePublicWorkerForm(String, String) 

getUserAgent(HttpSession) 

getUserData(HttpSession) 

getWorkerCount(HttpSession) 
CJ isSystemAvailableO 
,fl isValidSession(HttpSession) 

login(String t String, HttpSession) 

logout(HttpSession) 
01 main(String[]) 
||| makeDbConnection() 
™f* makeRMiConnection() 

processCustomWorkerCreateRequest(HttpSession, HttpServletRequest, QueryEngine) 
III processPublicWorkerCreateRequest(HttpSession, HttpServletRequest) 
ff\ processWorkerChangeRequest(HttpSession, HttpServletRequest) 
7' ShouldWorkerQueryAlways(String) 
^ validateDbConnection() 
CI validateRMIConnectionO 

Cp ChangeWorkerButtonld 

public static final String ChangeWorkerButtonld = "change" 

& CreatePublicWorkerButtonld 

public static final String CreatePublicWorkerButtonld = "create" 
m dbCheckSql 

protected String dbCheckSql = "select 'x' from dual" 

II DeleteWorkerButtonld 

public static final String DeleteWorkerButtonld = "delete" 

ft infoServerAccess 

protected IRemoteRepository infoServerAccess = null 

• jdbcConn 

protected Connection jdbcConn = null 

ft UserAgentld 

static final String UserAgentld = "UserAgent" 
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ft UserDatald 

static final String UserDatald = "UserData" 
ft userDb 

protected SMSAppDB userDb = null 




m JspBean 

public JspBean () 




ft getAgentWorkerEditForms 

public String [] getAgentWorkerEditForms (HttpSession sess, String actionAddr) 

Return array of HTML forms that presents ali of the data workers for the user. The forms are populated with values assigned to the 
worker, and allow the values to be updated. Also includes forms for disabling, enabling, and remove public agents, returns null if none 
found 

Parameter doc: 

Q session, response, and the address of the 'page' that processes the form 
%'P getCreatePublicWorkerForm 

lljjpublic String getCreatePublicWorkerForm (String callbackPage, String buttonLabel) 

%l Get the drop-down public list Form that is used to create a new Public Data Worker this is performed in here because of the complexity of 
yi the queries 

Eft getUserAgent 

51 protected UserAgent getUserAgent (HttpSession session) 

3| Get the UserAgent object for this session could return null if not defined protected for now; if JSP Really needs access, we can open it up 

111 

Qjft getUserData 

Jjpublic UserData getUserData (HttpSession session) 

Get the UserData object for this session could return null if not defined 

SI getWorkerCount 

public int getWorkerCount (HttpSession session) 
Return how many worker the user in this session has 

ft isSystemAvailable 

public boolean isSystemAvailable ( ) 

Validate that the RM1 and DB Connections are OK. Return true if all is OK. 

ft isValidSession 

public boolean isValidSession (HttpSession sess) 

Return true if this is a valid session already; i.e., has a UserAgent and UserData for the logged in user 

• login 

public boolean login (String userName, String password, HttpSession sess) 

Is this a valid username & password? If so, a session object is created and the UserAgent and UserData are loaded into the session If the 
session already exists for userName/password, then return true; Note that if internal connection (RMI, DB) are bad, then this returns false 
with no indication. 
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B logout 

public void logout {HttpSess ion sess) 
clear out the user session. 

• main 

public static void main (String [] args) 
8£ makeDbConnection 

protected void makeDbConnection ( ) 

Make sure jdbcConn is valid. If not, report the error to out and return false 

Throws: 

SQLException 

• makeRMIConnection 

protected void makeRMIConnection ( ) 

Connect the remote object to the server if necessary 

Throws: 

Exception 

f# processCustomWorkerCreateRequest 

•IJpublic void processCustomWorkerCreateRequest (HttpSess ion sess, HttpServletRequest request, 
^QueryEngine qe) 

S.I Process the request to create a worker from the specified data source TO DO: Have this created based on admin-assignable default values 
jjjfc processPublicWorkerCreateRequest 

fjijpublic void processPublicWorkerCreateRequest (HttpSess ion sess, HttpServletRequest request) 

^ Process the request to create a worker from public data source This actually just gets the public QE and then calls 
^ processCustomWorkerCreateRequest 

fifi processWorkerChangeRequest 

ftjpublic boolean processWorkerChangeRequest (HttpSe ssi on sess, HttpServletRequest request) 

M process the worker change request that would have originated from a form generated by getAgentWorkerEditForms() return the success 
EI of the operation 

• ShouIdWorkerQueryAlways 

public static boolean ShouIdWorkerQueryAlways (String qeld) 

Some QueryEngines should be always queried; this determines if ID is one of them, as defined by queryAlways in the prop file 

9. validateDbConnection 

protected void validateDbConnection ( ) 

Make sure con is valid. If not, report the error to out and throw the exception 

Throws: 

SQLException 

• validateRMIConnection 

protected boolean validateRMIConnection ( ) 

make connection if necessary; test the connection; if failed, try to to remake the connection return true if good connection 



H Class tcs.ainJnfoserver.simpleweb.PublicAgentListGenerator 

public class PublicAgentListGenerator 
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Extends: 

java.lang.Object 

Attributes 

agentWorkers 
i nf oServerAccess 
userAgent 
userData 

Constructors 

PublicAgentListGenerator(tcs.ain.infoserver.UserAgent, tcs.ain.appdata.UserData, tcs.ain.infoserver.access.lRemoteRepository) 
Operations 

getForms() 

• agentWorkers 

protected tcs .ain. inf oserver .DataWorker [3 agentWorkers 

• infoServerAccess 

protected tcs . ain . inf oserver . access . IRemoteRepository infoServerAccess 
gfd userAgent 

^■protected tcs .ain. inf oserver .UserAgent userAgent 

Hp userData 

tf protected tcs.ain.appdata.UserData userData 



p # PublicAgentListGenerator 

r| public PublicAgentListGenerator (tcs .ain. inf oserver .UserAgent , tcs .ain. appdata. UserData, 
^■ftcs . ain . inf oserver . access . IRemoteRepository) 



ft getForms 

public java . lang .String [ ] getForms {) 



|||||; 



llllllllllllll 



H Class tcs.ain. infoserver.simpleweb. UserWorkFormGenerator 

public class UserWorkFormGenerator 

This presents all of the Public Data Sources and provides relevant information for any UserAgents that reference the public sources TO DO: 
Remove hard-coded English in the form use more constants for field ids 



Attributes 

agentWorkers 

infoServerAccess 

IsRunningFId 

userAgent 

userData 

WorkerFId 

Constructors 



UserWorkFormGenerator(UserAgent f UserData, IRemoteRepository) 
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Operations 

DoesSourceHaveEmailListener(IDataEventSource) 

DoesSourceHaveSmsListener(IDataEventSource) 

getChangeOnlyField(DataWorker) 

getDestinationfields(DataWorker) 

getForms(String) 

getlsRunningFieid(DataWorker) 

getTimerFields(Data Worker) 



• agentWorkers 

protected DataWorker [ 3 agentWorkers = null 

• infoServerAccess 

protected IRemoteRepository infoServerAccess = null 

• IsRunningFId 

public static final String IsRunningFId = "isrunning" 

• userAgent 

protected UserAgent userAgent 
: ;® userData 

^protected UserData userData 

% WorkerFId 

^public static final String WorkerFId - "worker id" 

a|ss 

f!p UserWorkFormGenerator 

!IJ)ublic UserWorkFormGenerator (UserAgent ua, UserData ud, IRemoteRepository ir) 

Hi 

™J Called from the JspBean when user wants forms representing workers 



• DoesSourceHaveEmailListener 

protected static boolean DoesSourceHaveEmailListener (IDataEventSource source) 

Return whether this IDataEventSource has a listener of this class type (Email) Enumerates over the various listeners; recursively calls 
itseif for Filter types 

II DoesSourceHaveSmsListener 

static boolean DoesSourceHaveSmsListener (IDataEventSource source) 

Return whether this IDataEventSource has a listener of this class type (SMS) Enumerates over the various listeners; recursively calls itself 
for Filter types There must be a more efficient way to do this 

9t getChangeOnlyField 

protected StringBuffer getChangeOnlyField {DataWorker worker) 
return the ChangeOnly label and checkbox 

• getDestinationfields 

protected StringBuffer getDestinationfields (DataWorker worker) 
Return fields for whether SMS and/or Email Destinations are to be used 
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• getForms 

public String [] getForms (String actionAddr) 

Return an array of Strings, each of which contains a form for viewing and editing the worker agents. An array is returned because the 
calling JSP page might want to put each form in a table cell, or something similar for formatting purposes, receive page address that 
process the form action 

9 getlsRunningField 

protected StringBuffer getlsRunningField (DataWorker worker) 
Get fields for whether agent is running 

• getTimerFields 

protected StringBuffer getTimerFields (DataWorker worker) 

Return the timer selection fields for the queryengine Min of hour, Hour of day, DOW, DOM 

B Class tcs.ainJnfoserver.simpleweb.UserWorkFormProcessor 

public class UserWorkFormProcessor 

This guy applies change requests for a worker against the useragent, which is obtained by querying the session 

Attributes 

dataWorker 
Ci infoServerAccess 
J : | request 
J» userAgent 
J;? userData 
11 

Uponstructors 

J!! UserWorkFormProcessor(UserAgent, UserData, IRemoteRepository, HttpServlet Request) 
"^pperations 

l ^ addEmailSupport(!DataSource, IDataEventSource) 
* addSmsSupport(lDataSource, IDataEventSource) 
Q applyChangeOnlyO 
ffl appiyDestinationFie!ds() 

applylsRunningO 
IU applyTimerFields() 
Q getWorkerChangeOnlyFilterO 
i% processFormO 

^"f removeEmailSupport( IDataEventSource) 
^ removeSmsSupport(l DataEventSource) 




• dataWorker 

protected DataWorker dataWorker = null 
II infoServerAccess 

protected IRemoteRepository infoServerAccess = null 

• request 

HttpServletRequest request = null 

• userAgent 

protected UserAgent userAgent = null 
@ userData 

protected UserData userData = null 
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ft UserWorkFormProcessor 



public UserWorkFormProcessor (UserAgent ua, UserData ud, IRemoteRepository ir, HttpServletRequest 
request) 

Called from the JspBean when we need to apply the results of having clicked on a form generated bby the UserWorkFormGenerator 
• addEmailSupport 

protected void addEmailSupport (IDataSource dataSource, IDataEventSource evtSource) 
add Email listener to this source TO DO: Pull Email constants from property file 

ft addSmsSupport 

protected void addSmsSupport {IDataSource dataSource, IDataEventSource evtSource) 
add Email listener to this source TO DO: Pull SMS constants from property file 

ft applyChangeOnly 

protected void applyChangeOnly { ) 

Add or Remote a ChangeOnlyFilter, as directed by the checkbox. 

Throws: 

^ Exception 

Wlft applyDestinationFieids 

''^|protected void applyDestinationFieids ( ) 

I'll Apply the request to add/remove Destination TO DO: Make sure that what's happening with applyChangeOnly does not strangely affect 
7tll this and vice-versa 



ft applylsRunning 

^protected void applylsRunning ( ) 
f|| Check and apply the isRunning field 

W Throws: 

C} Exception 

ft applyTimerFields 

protected void applyTimerFields ( ) 

apply the timer fields; taking into special consideration the 'combined' time possibilities 

Throws: 

Exception 

ft getWorkerChangeOnlyFilter 

protected ChangeOnlyFilter getWorkerChangeOnlyFilter ( ) 

Return a ChangeOnlyFilter that may be assigned to the dataWorker. ff none is assigned, return null 

ft processForm 

public boolean processForm ( ) 

Check each of the possible fields and then save the agent return false if the form could not be processed; Note: We could also throw an 
exception to give more detail; 

ft removeEmailSupport 

protected void removeEmailSupport (IDataEventSource source) 
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Remove EmailDestination from the DataEventSource 

• removeSmsSupport 

protected void removeSmsSupport (IDataEvent Source source) 
Remove SmsDestinatton from the DataEventSource 



Package tcs.ain . infoserver. simpleweb2 *zip 



^ Classes 

class tcs.ain. infoserver. si mpleweb.CustomWebSourceFormGenerator 
class tcs.ain. infoserver. si mpleweb. J spBean 
class tcs.ain.infoserver.simpieweb.PublicAgentListGenerator 
class tcs.ain.infoserver.simpleweb.UserWorkFormGenerator 
class tcs.ain. infoserver.simpleweb.UserWorkFormProcessor 



H Class tcs.ain. infoserver.simpleweb. CustomWebSourceFormGenerator 

public class CustomWebSourceFormGenerator 
PI This presents all of the Public Data Sources and provides relevant information for any UserAgents that reference the 

K 

^Attributes 

fsl returnJsp 
!^ SaveButtonld 

Constructors 

hf CustomWebSourceFormGenerator(String) 
^Operations 

L;. getForm For Data Wo rker(Data Worker) 
y getFormHtml(Hashtable, String, String) 
f|| getNewFormHtml(String, String) 
fit getPageParserQueryEngine(DataWorker) 

getPageParserQueryEngineFromForm(HttpServletRequest) 

& returnJsp 

String returnJsp 

Mf SaveButtonld 

public static String SaveButtonld = "save" 



public sources 



WBmm 



# CustomWebSourceFormGenerator 

public CustomWebSourceFormGenerator (String returnJsp} 
Called from the JspBean when user wants forms representing workers 



• getFormForDataWorker 

public String getFormForDataWorker (DataWorker worker) 
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Show the data selection form, but based on the PageParserQE already contained by this worker This is useful when/if we want to edit an 
existing Web QueryEngine 

Throws: 

Exception 

• getFormHtml 

protected String getFormHtml (Ha sht able current Selectedl terns , String href, String startText) 

Generate the form for selecting data from the href, setup the field to checked if currentSelectedltems contains the field already TO DO: It 
would be really great to sort entries by confidence level! 

Throws: 

Exception 

• getNewFormHtml 

public String getNewFormHtml (String href, String startText) 

show a new form for selecting content startText can be null or 0 length if not relevant includes a 'saveform' submit button at the end. 

Throws: 

Exception 

• getPageParserQueryEngine 

static PageParserQueryEngine getPageParserQueryEngine (DataWorker worker) 
Return a PageParserQueryEngine if associated with this data source, return null if none found 

%H getPageParserQueryEngineFromForm 

Jvjbublic PageParserQueryEngine getPageParserQueryEngineFromForm (HttpServletRequest request) 

||] 

"fi Create and return a PageParserQueryEngine based on the form variables. 

|,y Throws: 

3| Exception 




Class ics.ain.infoserver.simpleweb.JspBean 



fljpublic class JspBean 

MfTiis provides some methods to simplify access to QNet and also return some dynamic HTML content. 

^Attributes 

infoServerAccess 

jdbcConn 

UserAgentld 

UserDatald 

userDb 

Constructors 

JspBean() 

Operations 

createEmailQueryEngine(HttpServletRequest) 

getAgentWorkerEditForms(HttpSession f String) 

getCreatePublicWorkerForm(String, String) 

getUserAgent(HttpSession) 

getUserData(HttpSession) 

getWorkerCount(HttpSession) 

isSystemAvailableO 

isValidSession(HttpSession) 

login(String, String, HttpSession) 

logout(HttpSession) 

main(String[]) 

makeDbConnection() 

makeRMIConnectionQ 
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processCustomWorkerCreateRequest(HttpSession, HttpServletRequest, QueryEngine) 
processPublicWorkerCreateRequest(HttpSession, HttpServletRequest) 
processWorkerChangeRequest(HttpSession, HttpServletRequest) 
validateDbConnection() 
vaiidateRMIConnectionQ 



ft infoServerAccess 

protected J RemoteRepository infoServerAccess = null 

ft jdbcConn 

protected Connection jdbcConn = null 
ft UserAgentld 

static final String UserAgentld = "UserAgent" 

ft UserDatald 

static final String UserDatald = "UserData" 

ft userDb 

protected SMSAppDB userDb = null 



WS&m 



||;||J|||||| 



if§ JspBean 

Jgubl i c JspBean ( ) 



i: ft createEmailQueryEngine 

public NewEmail QueryEngine createEmailQueryEngine (HttpServletRequest request) 

p Based on the parameters received from the request, attempt to create a NewEmailQueryEngine object. Throw an Exception with 
•X description of the problem if there is one. TO DO: DNS Validation, as with serviet, Remove Hard-Coded names 

m Throws: 

Exception 

ft getAgentWorkerEditForms 

public String [] getAgentWorkerEditForms (HttpSess ion sess, String actionAddr) 

Return array of HTML forms that presents all of the data workers for the user. The forms are populated with values assigned to the 
worker, and allow the values to be updated. Also includes forms for disabling, enabling, and remove public agents, returns null if none 
found 

Parameter doc: 

session.response, and the address of the 'page' that processes the form 
ft getCreatePublicWorkerForm 

public String getCreatePublicWorkerForm (String callbackPage , String buttonLabel) 
Get the Form that is used to create a new Public Data Worker 

ft getUserAgent 

public UserAgent getUserAgent (HttpSession session) 
Get the UserAgent object for this session could return null if not defined 
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• getUserData 

public UserData getUserData (HttpSession session) 
Get the UserData object for this session could return nuii if not defined 

• getWorkerCount 

public int getWorkerCount (HttpSession session) 
Return how many worker the user in this session has 

• isSystemAvailable 

public boolean isSystemAvailable ( ) 

Validate that the RMI and DB Connections are OK. Return true if all is OK. 

& isValidSession 

public boolean isValidSession (HttpSession sess) 

Return true if this is a valid session already; i.e., has a UserAgent and UserData for the logged in user 

© login 

public boolean login (String userName, String password, HttpSession sess) 

Is this a valid username & password? If so, a session object is created and the UserAgent and UserData are loaded into the session If the 
session already exists for userName/password, then return true; Note that if internal connection (RMI, DB) are bad, then this returns false 
pt : with no indication. 

Jfl logout 

^public void logout (HttpSession sess) 
||| clear out the user session. 

main 

|tf)ublic static void main(String [] args) 

Hfl makeDbConnection 

flfirotected void makeDbConnection ( ) 

Make sure jdbcConn is valid, if not, report the error to out and return false 

jSIji Throws: 

««t SQLException 

• makeRMIConnection 

protected void makeRMIConnection ( ) 

Connect the remote object to the server if necessary 

Throws: 

Exception 

• processCustomWorkerCreateRequest 

public void processCustomWorkerCreateRequest {HttpSession sess, HttpServletRequest request, 
QueryEngine qe) 

Process the request to create a worker from the specified data source TO DO: Have this created based on admin-assignable default values 

• processPublicWorkerCreateRequest 

public void processPublicWorkerCreateRequest (HttpSession sess, HttpServletRequest request) 

Process the request to create a worker from public data source This actually just gets the public QE and then calls 
processCustomWorkerCreateRequest 
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• processWorkerChangeRequest 

public boolean processWorkerChangeRequest (HttpSession sess, HttpServlet Request request) 

Process the worker change request that would have originated from a form generated by getAgentWorkerEditForms() return the success 
of the operation 

ft validateDbConnection 

protected void validateDbConnection ( ) 

Make sure con is valid, if not, report the error to out and throw the exception TO DO: RECONNECT ON FAILURE 

Throws: 

SQLException 

ft validateRMIConnection 

protected boolean validateRMIConnection ( ) 

make connection if necessary; test the connection; if failed, try to to remake the connection return true if good connection 

B Class tcs.ain/infoserver.simpleweb. PublicAgentListGenerator 

public class PublicAgent List Genera tor 

Extends: 

java.lang.Object 

Attributes 

%l agentWorkers 
III infoServerAccess 
fJl userAgent 

w * userData 

f ? 

uponstructors 

HI PublicAgent Li stGenerator(tcs.ain.infoserver. UserAgent, tcs. ain. appdata. UserData, tcs.ain.infoserver.access. IRemoteRepository) 

Z^pperations 

;JI getFormsQ 



agentWorkers 

-"protected tcs . a in. inf oserver .Da taWorker [] agentWorkers 

ft infoServerAccess 

protected tcs . ain . inf oserver . access . IRemoteRepository infoServerAccess 
ft userAgent 

protected tcs . ain. inf oserver .UserAgent userAgent 

ft userData 

protected tcs .ain . appdata .UserData userData 



Constructor Detail 

& PublicAgentListGenerator 

public PublicAgentListGenerator ( tcs . ain . inf oserver . UserAgent , tcs . ain . appdata . UserData , 
tcs . ain . inf oserver . access . IRemoteRepository) 
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Operation Detail 



• getForms 

public java. lang . String [] getForms () 

B Class tcs.ainJnfoseiver.simpleweb.UserWorkFormGenerator 

public class UserWorkFormGenerator 

This presents all of the Public Data Sources and provides relevant information for any UserAgents that reference the public sources 

Attributes 

agentWorkers 

EveryldLbl 

infoServerAccess 

IsRunningFId 

userAgent 

userData 

WorkerFId 

Constructors 

UserWorkForm Gen era tor( UserAgent, UserData, IRemoteRepository) 

Operations 

P% DoesSourceHaveEmailListener(lDataEventSource) 

DoesSourceHaveSmsListener(l Data Even tSource) 

%1 getChangeOnlyField(DataWorker) 

HJ getDestinationf ields(DataWorker) 

f** getForms(String) 

rll getlsRunningField(DataWorker) 

y ■}. getTimerFields(Data Worker) 



ite Det 



• agentWorkers 

protected DataWorker[] agentWorkers = null 

ti' 

III EveryldLbl 

^public static String EveryldLbl = "Every" 

% infoServerAccess 

protected IRemoteRepository infoServerAccess = null 

• IsRunningFId 

public static final String IsRunningFId = "isrunning" 

• userAgent 

protected UserAgent userAgent 

@ userData 

protected UserData userData 

• WorkerFId 

public static final String WorkerFId = "workerid" 
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Sf UserWorkFormGenerator 

public UserWorkFormGenerator (User Agent ua, UserData ud, IRemoteRepository ir) 
Called from the JspBean when user wants forms representing workers 



• DoesSourceHaveEmailListener 

protected static boolean DoesSourceHaveEmailListener { IDataEventSource source) 

Return whether this iDataEventSource has a listener of this class type (Email) Enumerates over the various listeners; recursively calls 
itself for Filter types 

• DoesSourceHaveSmsListener 

static boolean DoesSourceHaveSmsListener (IDataEventSource source) 

Return whether this IDataEventSource has a listener of this class type (SMS) Enumerates over the various listeners; recursively calls itself 
for Filter types There must be a more efficient way to do this 

• getChangeOnlyField 

protected StringBuffer getChangeOnlyField {DataWorker worker) 
l\ return the ChangeOnly label and checkbox 



getDestinationf ields 

^protected StringBuffer getDestinationf ields (DataWorker worker) 
*<M Return fields for whether SMS and/or Email Destinations are to be used 

l&fi getForms 

3j?ublic String [] getForms (String actionAddr) 

!L Return an array of Strings, each of which contains a form for viewing and editing the worker agents. An array is returned because the 
™l calling JSP page might want to put each form in a table cell, or something similar for formatting purposes, receive page address that will 
i J process the form action 

Jfi getlsRunningField 

^protected StringBuffer getlsRunningField {DataWorker worker) 
^ Get fields for whether agent is running 

• getTimerFields 

protected StringBuffer getTimerFields (DataWorker worker) 

Return the timer selection fields for the queryengine Min of hour, Hour of day, DOW, DOM 

B Class tcs.ainJnfoserver.simpleweb.UserWorkFormProcessor 

public class UserWorkFormProcessor 

This guy applies change requests for a worker against the useragent, which is obtained by querying the session 

Attributes 

dataWorker 

infoServerAccess 

request 

userAgent 

userData 

Constructors 

UserWorkFormProcessor(UserAgent, UserData, IRemoteRepository, HttpServletRequest) 
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Operations 

addEmailSupport(I DataSource, IDataEventSource) 

addSmsSupport(l DataSource, ! DataEventSource) 

applyChangeOnly() 

applyDesttnationFieldsO 

applylsRunningO 

applyTimerFields() 

getWorkerChangeOnIyFilter() 

processForm() 

removeEmailSupport(l DataEventSource) 
removeSmsSupport(l DataEventSource) 



• dataWorker 

protected DataWorker dataWorker = null 

• infoServerAccess 

protected IRemoteRepository infoServerAccess = null 
B: request 

HttpServlet Request request = null 

swfl userAgent 

protected UserAgent userAgent = null 



gji userData 

|j|>rotected UserData userData = null 



JlP UserWorkFormProcessor 

^public UserWorkFormProcessor (UserAgent ua, UserData ud, IRemoteRepository ir, HttpServletRequest 
■J'frequest) 

g Called from the JspBean when we need to apply the results of having clicked on a form generated bby the UserWorkFormGenerator 



• addEmailSupport 

protected void addEmailSupport {IDataSource dataSource, IDataEventSource evtSource) 
add Email listener to this source TO DO: Pull Email constants from property file 

• addSmsSupport 

protected void addSmsSupport (IDataSource dataSource, IDataEventSource evtSource) 
add Email listener to this source TO DO: Pull SMS constants from property file 

• applyChangeOnly 

protected void applyChangeOnly ( ) 

Add or Remote a ChangeOnlyFilter, as directed by the checkbox. 

Throws: 

Exception 

St applyDestinationFields 

protected void applyDestinationFields ( ) 
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Apply the request to add/remove Destination TO DO: Make sure that what's happening with applyChangeOnly does not strangely affect 
this and vice-versa 

ft applylsRunning 

protected void applylsRunning ( ) 
Check and apply the isRunning field 

Throws: 

Exception 

• applyTimerFields 

protected void applyTimerFields ( ) 

apply the timer fields; taking into special consideration the 'combined' time possibilities 

Throws: 

Exception 

• getWorkerChangeOnlyFiiter 

protected ChangeOnly Filter getWorkerChangeOnlyFiiter ( ) 

Return a ChangeOnly Filter that may be assigned to the dataWorker. If none is assigned, return null 

• processForm 

Qpublic boolean processForm ( ) 

%4 Check each of the possible fields and then save the agent return false if the form could not be processed; Note: We could also throw an 
%| exception to give more detail; 

HI 

y$l removeEmailSupport 

protected void removeEmailSupport (IDataEvent Source source) 
yu ; Remove Emai (Destination from the Data Even tSource 

* ft removeSmsSupport 

protected void removeSmsSupport (IDataEvent Source source) 
Remove SmsDestination from the DataEventSource 

LI 

i ^Package tcs.ain.infoserver.source 

& Class Diagrams 

diagram source 

^G^^lC^Mi^: : || : : ^ " -fig : :|- / V : 



Class Diagram source 
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Package fcs. ain. infoserver. tests 



& Class Diagrams 
diagram tests 



H Classes 



class 
class 
class 
class 
class 
class 
class 
class 
class 
class 
class 
class 
class 
class 
class 



tcs.ain. 
tcs.ain. 
tcs.ain. 
tcs.ain. 
tcs.ain. 
tcs.ain. 
tcs.ain. 
tcs.ain. 
tcs.ain. 
tcs.ain. 
tcs.ain. 
tcs.ain. 
tcs.ain. 
tcs.ain. 
tcs.ain. 



infoserver.tests 
infoserver.tests 
infoserver.tests 
infoserver.tests 
infoserver.tests 
infoserver.tests 
infoserver.tests 
infoserver.tests 
infoserver.tests 
infoserver.tests 
infoserver.tests 
infoserver.tests 
infoserver.tests 
infoserver.tests, 
infoserver.tests 



GSWDS 
Testl 
Testll 
Testl2 
Test2 
Test3 
Test4 
Testl 0 
Tests 
.Test6 
Test7 
Test8 
Test9 

TestPageParserQE 
WLabDS 




Class Diagram tests 



Testll 



+Testll 
+main : voi 



Test2 



+Test2 
+main : voi 



Tests 



+Test5 
+main : voi 




WLabDS 



+WLabDS 
+main: voi 



TestPageParserQE 



+TestPageParserQE 
+main: void 



Testl 



+Testl 
4-main: voi 



Testl2 



rep : IRemoteRepository 
userAgent : UserAgent 
agentWorkers : DataWorker 



+Testl2 

#showlnfo: void 
#showUserMatch : void 
#showAHUserWorkers : voi 
-f-main: void 



java . lang. Obj 
Test4 



+Test4 
+main: void 



Test6 



+Test6 
-f-irtain: voi 



Test3 



+Test3 
+main: voi 



Test9 



+Test9 
+main: voi 



Testl 0 



+TestlO 
+main: voi 



Test8 



+Test8 
4main: voi 



GSWDS 



+GSWDS 
+main: voi 
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Class Nodes 

tcs.ain.infoserver.tests.GSWDS 

tcs . a i n. i nfoserver. tests .Test 1 

tcs.ain.infoserver.tests.TestlO 

tcs.ain.infoserver.tests.Testll 

tcs.ainJnfoserver«tests.Testl2 

tcs.ainJnfoserver. tests. Test2 

tcs.a i n . inf oserver.tests . Test3 

tcs.ain.infoserver.tests.Test4 

tcs.ain.infoserver.tests. Tests 

tcs.ain.infoserver.tests.Test6 

tcs.ain.infoserver.tests.Test7 

tcs.ain.infoserver.tests. Test8 

tcs.ain.infoserver.tests.Test9 

tcs.ain.infoserver.tests.TestPageParserQE 

tcs.ain.infoserver.tests.WLabDS 



B Class tcs.ain.infoserver.tests.GSWDS 

Tests the IMAP Query Engine; query every one minute 

B Class tcs.ain.infoserver.tests.Testl 

^ This class create a WebQueryEngine, 2 DataWorkers, SimpieUserDestination and ties them ail together. The dataworker will execute 
%f once, causing the XML from the horoscope web page to be seen on the screen. 

Jp3 Class tcs.ain.infoserver.tests.TestlO 

111 Adds on to Test3 by saving to the Repository. 

lllB Class tcs.ain.infoserver.tests.Testl 1 

m 

5£ Tests the IMAP Query Engine; query every one minute 
rljH Class tcs.ain.infoserver.tests.Testl2 

l^l This test just shows all of the Data Sources and interleaves userUser info If the user has 'signed up' with this source, then user info is 
M shown. 

" B Class tcs. ain.infoserver.tests.Test2 

Adds on to Testl by assigned an XSL doc to the DataSource, and assigning a formatter that uses that XSL doc. 

B Class tcs.ain.infoserver.tests.Test3 
Adds on to Test2 by using the CalendarTimer. 

B Class tcs.ain.infoserver.tests.Test4 

Extends: 

java.lang.Object 

B Class tcs.ain.infoserver.tesis.TestS 

Loads the objects saved in Test4. Workers will start to auto-run. This is what InfoServer.main does also. 

B Class tcs.ain.infoserver.tests.Test6 

Gets the InfoserverAccess object. Creates an UserAgent and saves it to the InfoServerAccess remote object. 
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I Class tcs.ainjnfo$erver.test$.Test7 

Gets the InfoserverAccess object Retrieves the UserAgent saved in Test6. 
I Class tcs.ain.info$erver.te$t$.Test8 

Tests the I MAP Query Engine; query every one minute 

I Class tcs.ain.infoserver.tests.Test9 

Single worker, single data source for I MAP, with 2 XSL styles. Two destinations, each using a different style sheet. Dest 1 inserts the 
Email data into a database for the IVR reader Dest 2 displays the at the MIN. 

I Class tcs.ain.infoserver.tests.TestPageParserQE 

This creates a PageParserQueryEngine and has a DataWorker query it 

I Class tcs.ain.infoserverAests.WLabDS 
Tests the I MAP Query Engine; query every one minute 



//ass Detail 



tm Class tcs.ain.infoserver. tests. GSWDS 

fljbublic class GSWDS 

^JjTests the IMAP Query Engine; query every one minute 

^Constructors 

W GSWDSO 

^Operations 

||] main(String[]) 



*m GSWDS 

public GSWDSO 

Throws: 

Exception 



Wt main 

public static void main (String [] args) 



H Class tcs.ain.infoserver.tests. Testl 

public class Testl 

This class create a WebQuery Engine, 2 DataWorkers, SimpleUserDestination and ties them all together. The dataworker will execute once, 
causing the XML from the horoscope web page to be seen on the screen. 



Constructors 

Test 1() 
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Operations 

main(String[]) 



• Testl 

public Testl () 



• main 

public static void main (String [3 args) 

B Class fcs. ain.infoserver. tests. Testl 0 

public class TestlO 

Adds on to Test3 by saving to the Repository. 

Constructors 

TestlOO 

Operations 

%$ main(String[]) 




Jm TestlO 

public TestlO () 

a Throws: 

f*\ Exception 



Gil main 

^"public static void main {String [] args) 



H Class tcs.ain.infoserver.tests. Testl 1 

public class Testll 

Tests the IMAP Query Engine; query every one minute 

Constructors 

Testl 1() 

Operations 

main(String[]) 



m Testll 

public Testll ( ) 

Throws: 

Exception 



■■■■■ 
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191 main 

public static void main (String [] args) 

B Class fcs. ain. infoserver. tests. Testl 2 

public class Testl2 

This test just shows ail of the Data Sources and interleaves userUser info If the user has 'signed up 1 with this source, then user info is shown. 

Attributes 

agentWorkers 
rep 

userAgent 

Constructors 

Testl2(String) 

Operations 

main(String[]) 

showAIIUserWorkersO 

showlnfo() 

showUserMatch(String) 



{|p agentWorkers 

yjataWorker [] agentWorkers = null 

UP rep 

WRemoteRepository rep = null 

CH userAgent 

yfrserAgent userAgent = null 



Constructor Detail 

% Testl2 

public Test 12 (String uName) 



• main 

public static void main (String [] args) 

81 showAIIUserWorkers 

protected void showAIIUserWorkers ( ) 

• showlnfo 

protected void showlnfo { ) 

Throws: 

Exception 



^^^^^^^^^^^ 
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• showUserMatch 

protected void showUserMatch (String sourceKey) 

B Class tcs. ain. infoserver. tests. Test2 

public class Test2 

Adds on to Testl by assigned an XSL doc to the DataSource, and assigning a formatter that uses that XSL doc. 

Constructors 

Test2() 

Operations 

main(String[]) 




m Test2 



public Test 2 ( ) 



Throws: 

Exception 




Xion Detail 




fill main 

I? public static void main (String [ ] args) 




aB Class tcs.ain.infoserver.tests. Test3 

^public class Test 3 

JjAdds on to Test2 by using the CalendarTimer. 



l^ponstructors 



Test3o 

^Operations 



main(String[]) 



Construi 




* Test3 



public Test3 ( ) 



Throws: 

Exception 



Operation 0< 




• main 

public static void main (String [] args) 



Class tcs.ain.infoserver.tests. Test4 



public class Test4 
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Extends: 

java.lang.Object 

Constructors 

Test4() 

Operations 

mainGava.lang.String[]) 



• Test4 

public Test4 ( ) 



81 main 

public static void main {java . lang . String [] ) 

B Class tcs.ain.infoserver.tests. Tests 

Qbublic class Tests 

Ntoads the objects saved in Test4. Workers will start to auto-run. This is what InfoServer.main does also. 

Constructors 

l U Test5() 

^Operations 

m main(String[]) 



ictorOi 
# TestB 

Qniblic Tests () 

CI 

T; Throws: 

r "" Exception 



8;::::: : ;:E: : ::E:::;::::E:-.;! 



• main 

public static void main (String [ 3 args) 



H Class tcs. ain.infoserver. tests. Test6 

public class Teste 

Gets the InfoserverAccess object. Creates an UserAgent and saves it to the InfoServerAccess remote object. 

Constructors 

Test6() 

Operations 

main(String[]) 
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m Test6 

public Teste { ) 

Throws: 

Exception 



• main 

public static void main {String [] args) 



H Class tcs.ain.infoserver.tests. Test7 

public class Test7 

Gets the I nfoserver Access object. Retrieves the UserAgent saved in Test6. 
Constructors 

Test7() 

s^pperations 

- main(String[]) 




m Test7 

public Test7() 

=• Throws: 

Q Exception 




Mi main 

"public static void main { String [] args) 



H Class tcs. ain.infoserver. tests. Test8 

public class Test8 

Tests the I MAP Query Engine; query every one minute 

Constructors 

TestS() 

Operations 

main(StringLl) 

m Test8 

public Test8 ( ) 



Throws: 

Exception 
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9 main 

public static void main (String [] args) 

B Class tcs. ain. infoserver. tests. Test9 

public class Test9 

Single worker, single data source for IMAP, with 2 XSL styles. Two destinations, each using a different style sheet Dest 1 inserts the Email 
data into a database for the IVR reader Dest 2 displays the at the MIN. 

Constructors 

Test9(String, String, String) 

Operations 

main(String[]) 



m Test9 

public Test9 (String emailServer, String emailAcct, String emailPW) 

□ 

1; fi Throws: 
Q Exception 

tall main 

ic static void main (String [] args) 



nifi Class tcs. ain.intoserver. tests. TestPageParserOE 

^public class TestPageParserQE 

5^ This creates a PageParserQueryEngine and has a DataWorker query it 

hi 

* Constructors 

TestPageParserQEO 

Operations 

main(String[]) 

TestPageParserQE 

public TestPageParserQEO 

Throws: 

Exception 



Wllliil^^ 

• main 

public static void main (String [ ] args) 



Page 324 of 324 



H Class tcs. a/n. infoserver. tests. WLabDS 

public class WLabDS 

Tests the (MAP Query Engine; query every one minute 

Constructors 

WLabDSO 

Operations 

main(String[]) 



• WLabDS 

public WLabDSO 

Throws: 

Exception 



e pmain 

v : f public static void 

5 



(String!] args) 



fcs. ain. infoserver. version 1 *zip 



a 

in 
m 



tcs.ain.infoserver.simpleweb.CustomWebSourceFormGenerator 

tcs.ainJnfoserver.simpleweb.JspBean 

tcs.ainjnfoserver.simpieweb.PublicAgentListGenerator 

tcs.ain.infoserver.simpleweb.UserWorkFormGenerator 

tcs.ain.infoserver.simpieweb.UserWorkFormProcessor 




NiBHBHHHtfHHBBIIII^HH 



Class tcs.ain.infoserver.simpleweb. Custom WebSourceFormGenerator 

public class CustomWebSourceFormGenerator 

This presents all of the Public Data Sources and provides relevant information for any UserAgents that reference the public sources 

Attributes 

returnJsp 
SaveButtonld 

Constructors 

CustomWebSourceFormGenerator(String) 

Operations 

getFormForDataWorker(DataWorker) 
getFormHtml(Hashtable, String, String) 
getNewFormHtml(String, String) 
getPageParserQueryEngine(DataWorker) 
getPageParserQueryEngineFromForm(HttpServietRequest) 
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• returnJsp 

String returnJsp 

• SaveButtonld 

public static String SaveButtonld = "save" 

• CustomWebSourceFormGenerator 

public CustomWebSourceFormGenerator {String returnJsp) 
Called from the JspBean when user wants forms representing workers 

Wt getFormForDataWorker 

public String getFormForDataWorker (DataWorker worker) 

Show the data selection form, but based on the PageParserQE already contained by this worker 

!3J Throws: 

n Exception 

^protected String getFormHtml (Hashtable currentSelectedltems, String href, String startText) 
|l| Generate the form for selecting data from the href, setup the field to checked if currentSelectedltems contains the field already 

m Throws: 

^ Exception 

till getNewFormHtml 

!||>ublic String getNewFormHtml (String href, String startText) 

show a new form for selecting content startText can be null or 0 length if not relevant includes a 'saveform' submit button at the end. 

H Throws: 

Exception 

• getPageParserQueryEngine 

static PageParserQueryEngine getPageParserQueryEngine (DataWorker worker) 
Return a PageParserQueryEngine if associated with this data source, return null if none found 

getPageParserQueryEngineFromForm 

public PageParserQueryEngine get Page Par serQueryEng ineFromForm (HttpServletRequest request) 
Create and return a PageParserQueryEngine based on the form variables. 

Throws: 

Exception 



H Class tcs.ain.infoserver.simpleweb.JspBean 

public class JspBean 

This provides some methods to simplify access to QNet and also return some dynamic HTML content. 
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Attributes 

infoServerAccess 

jdbcConn 

UserAgentld 

UserDataid 

userDb 

Constructors 

JspBean() 

Operations 

createEmailQueryEngine(HttpServietRequest) 

getAgentWorkerEditForms(HttpSession t String) 

getCreatePublicWorkerForm(String) 

getUserAgent(HttpSession) 

getUserData(HttpSession) 

getWorkerCou nt(H ttpSess i on) 

i sSy stem A va i 1 a bl e() 

isVaiidSession(HttpSession) 

iogin(String, String, HttpSession) 

logout(HttpSession) 

main(String[]) 

makeDbConnection() 

makeRMiConnectionO 

processCustomWorkerCreateRequest(HttpSession, HttpServletRequest, QueryEngine) 
processPublicWorkerCreateRequest(HttpSession, HttpServletRequest) 
processWorkerChangeRequest(HttpSession, HttpServletRequest) 
validateDbConnection() 
tfl validateRMIConnection() 

,fpi- infoServerAccess 

Unprotected. IRemoteRepository infoServerAccess = null 

s & jdbcConn 

Unprotected Connection jdbcConn = null 

m 

Wm UserAgentld 

rt 

^'static final String UserAgentld = "UserAgent" 

■ P 

Hi UserDataid 

static final String UserDataid = "UserData" 

• userDb 

protected SMSAppDB userDb = null 



II JspBean 

public JspBean () 

• createEmailQueryEngine 

public NewEmail QueryEngine createEmailQueryEngine (HttpServletRequest request) 

Based on the parameters received from the request, attempt to create a NewEmailQueryEngine object. Throw an Exception with 
description of the problem if there is one. TO DO: DNS Validation, as with servlet 
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Throws: 

Exception 

• getAgentWorkerEditForms 

public String[] getAgentWorkerEditForms (HttpSession sess, String actionAddr) 

Return array of HTML forms that presents all of the data workers for the user. The forms are populated with values assigned to the 
worker, and allow the values to be updated. Also includes forms for disabling, enabling, and remove public agents, returns null if none 
found 

Parameter doc: 

session, response, and the address of the 'page* that processes the form 

• getCreatePublicWorkerForm 

public String getCreatePublicWorkerForm (String callbackPage) 
Get the Form that is used to create a new Public Data Worker 

• getUserAgent 

public UserAgent getUserAgent (HttpSession session) 
Get the UserAgent object for this session could return null if not defined 

9t getUserData 

^public UserData getUserData (HttpSession session) 

|| Get the UserData object for this session could return null if not defined 

*%fk. getWorkerCount 

Ipublic int getWorkerCount (HttpSession session) 
Return how many worker the user in this session has 

I# isSystemAvailable 

'public boolean isSystemAvailable () 

Validate that the RMI and DB Connections are OK. Return true if all is OK. 

isValidSession 

public boolean isValidSession (HttpSession sess) 

•sir 

„ ; | Return true if this is a valid session alreaay; i.e., has a UserAgent and UserData for the logged in user 

• login 

public boolean login (String userName, String password, HttpSession sess) 

Is this a valid username & password? If so, a session object is created and the UserAgent and UserData are loaded into the session If the 
session already exists for userName/password, then return true; Note that if internal connection (RMI, DB) are bad, then this returns false 
with no indication. 

• logout 

public void logout (HttpSession sess) 
clear out the user session. 

• main 

public static void main (String [] args) 

• makeDbConnection 

protected void makeDbConnection ( ) 

Make sure jdbcConn is valid. If not, report the error to out and return false 
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Throws: 

SQLException 

• makeRMIConnection 

protected void makeRMIConnection { } 

Connect the remote object to the server if necessary 

Throws: 

Exception 

• processCustomWorkerCreateRequest 

public void processCustomWorkerCreateRequest (HttpSess ion sess, HttpServletRequest request, 
QueryEngine qe) 

Process the request to create a worker from the specified data source TO DO: Have this created based on admin-assignable default values 

• processPublicWorkerCreateRequest 

public void processPublicWorkerCreateRequest (HttpSession sess, HttpServletRequest request) 

Process the request to create a worker from public data source This actually just gets the public QE and then calls 
processCustomWorkerCreateRequest 

H processWorkerChangeRequest 

^public boolean processWorkerChangeRequest (HttpSession sess, HttpServletRequest request) 

^1 Process the worker change request that would have originated from a form generated by getAgentWorkerEditForms() return the success 
SI of the operation 

fill validateDbConnection 

Jprotected void validateDbConnection ( ) 

to Make sure con is valid. If not, report the error to out and throw the exception TO DO: RECONNECT ON FAILURE 

Throws: 

^ SQLException 

yfe validateRMIConnection 

^protected void validateRMIConnection ( ) 

Q make connection if necessary; test the connection; if failed, try to to remake the connection return true if good connection 

B Class tcs.ainJnfoserver.simpleweb.PublicAgentListGenerator 

public class PublicAgentListGenerator 

Extends: 

java.lang.Object 

Attributes 

agentWorkers 
infoServerAccess 
userAgent 
userData 

Constructors 

PublicAgentListGenerator(tcs.ain.infoserver.UserAgent, tcs.am.appdata. UserData, tcs.ain.infoserver.access.lRemoteRepository) 

Operations 

getFormsO 



• agentWorkers 
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protected tcs .ain . inf oserver .DataWorker [] agentWorkers 
ft infoServer Access 

protected tcs . ain . inf oserver . access . IRemoteRepository inf oServerAccess 
ft userAgertt 

protected tcs .ain. inf oserver .UserAgent userAgent 

• userData 

protected tcs .ain. appdata. UserData userData 

• PublicAgentListGenerator 

public PublicAgentListGenerator (tcs . ain . inf oserver . UserAgent , tcs . ain . appdata .UserData, 
tcs . ain . inf oserver . access . IRemoteRepository) 

ft get Forms 

*«j?ublic j ava . lang . String [] get Forms { ) 



lllB Class tcs. ain.infoserver. simpleweb. UserWorkForm Generator 

^jpublic class UserWorkFormGenerator 

JT§This presents all of the Public Data Sources and provides relevant information for any UserAgents that reference the public sources 

^"Attributes 

w agentWorkers 

M EveryldLbl 

111 inf oServerAccess 

Fit isRunningFId 

PI userAgent 

W s userData 

6} WorkerFId 

^Constructors 

UserWorkFormGenerator(UserAgent f UserData, IRemoteRepository) 

Operations 

DoesSourceHaveEmailListener(IDataEventSource) 

DoesSourceHaveSmsListener(IDataEventSource) 

getChangeOnlyField(DataWorker) 

getDestinationfields(DataWorker) 

getForms(Slring) 

getlsRunningFteld(DataWorker) 

getTimerFields(DataWorker) 



etail 

ft agentWorkers 

protected DataWorker [] agentWorkers = null 

ft EveryldLbl 

public static String EveryldLbl = "Every" 

ft infoServerAccess 
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protected IRemoteRepository inf oServerAccess = null 

& IsRunningFId 

public static final String IsRunningFId = "isrunning" 
• userAgent 

protected UserAgent userAgent 
•f userData 

protected UserData userData 

m WorkerFId 

public static final String WorkerFId = "worker id" 




• UserWorkFormGenerator 

public UserWorkFormGenerator (UserAgent ua, UserData ud, IRemoteRepository ir) 
Called from the JspBean when user wants forms representing workers 




Jji DoesSourceHaveEmailListener 

If protected static boolean DoesSourceHaveEmailListener { IDataEventSource source) 

Si Return whether this IDataEventSource has a listener of this class type (Email) Enumerates over the various listeners; recursively calls 
y itself for Filter types 



^'*Qt DoesSourceHaveSmsListener 

^static boolean DoesSourceHaveSmsListener (IDataEventSource source) 

fll Return whether this IDataEventSource has a listener of this class type (SMS) Enumerates over the various listeners; recursively calls itself 
l\l for Filter types There must be a more efficient way to do this 

-J?* getChangeOniyField 

^protected StringBuffer getChangeOniyField (DataWorker worker) 
return the ChangeOnly label and checkbox 

ft- getDestinationfieids 

protected StringBuffer getDestinationfieids (DataWorker worker) 
Return fields for whether SMS and/or Email Destinations are to be used 

• getForms 

public String [] getForms {String actionAddr) 

Return an array of Strings, each of which contains a form for viewing and editing the worker agents. An array is returned because the 
calling JSP page might want to put each form in a table cell, or something similar for formatting purposes, receive page address that will 
process the form action 

• getlsRunningField 

protected StringBuffer getlsRunningField (DataWorker worker) 
Get fields for whether agent is running 

• getTimerFields 

protected StringBuffer getTimerFields (DataWorker worker) 
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Return the timer selection fields for the queryengine Min of hour, Hour of day, DOW, DOM 



H Class tcs.ain/mfoserver.simpleweb.UserWorkFormProcessor 

public class UserWorkFormProcessor 

This guy applies change requests for a worker against the useragent, which is obtained by querying the session 

Attributes 

dataWorker 

infoServerAccess 

request 

userAgent 

userData 

Constructors 

UserWorkFormProcessor(UserAgent, UserData, IRemoteRepository, HttpServletRequest) 

Operations 

addEmailSupport(IDataSource, IDataEventSource) 

addSmsSupport(IDataSource t IDataEventSource) 

applyChangeOnlyO 

applyDestinationFieldsQ 

applylsRunningO 

applyTimerFields() 
0 getWorkerChangeOnlyFilterO 
'SI processFormO 

y*l removeEmailSupport(IDataEventSource) 
? -l removeSmsSupport(IDataEventSource) 

UM dataWorker 

Protected DataWorker dataWorker = null 

CM infoServerAccess 

-protected IRemoteRepository infoServerAccess = null 

fu 

CiW request 

rl 

^HttpServletRequest request - null 

• userAgent 

protected UserAgent userAgent = null 

• userData 

protected UserData userData = null 



H UserWorkFormProcessor 

public UserWorkFormProcessor (UserAgent ua, UserData ud, IRemoteRepository ir, HttpServletRequest 
request) 

Called from the JspBean when we need to apply the results of having clicked on a form generated bby the UserWorkFormGenerator 



• addEmailSupport 

protected void addEmailSupport ( IDataSource dataSource, IDataEventSource evtSource) 
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add Email listener to this source TO DO: Pull Email constants from property file 
ft addSmsSupport 

protected void addSmsSupport (IDataSource dataSource, IDataEventSource evtSource) 
add Email listener to this source TO DO: Pull SMS constants from property file 

ft applyChangeOnly 

protected void applyChangeOnly ( ) 

Add or Remote a ChangeOnlyFilter, as directed by the checkbox. 

Throws: 

Exception 

ft appIyDestinationFields 

protected void appIyDestinationFields ( ) 

Apply the request to add/remove Destination TO DO: Make sure that what's happening with applyChangeOnly does not strangely affect 
this and vice-versa 

ft applylsRunning 

protected void applylsRunning () 
Check and apply the isRunning field 

Q 

Throws: 

^! Exception 

ft applyTimerFields 

^protected void applyTimerFields ( ) 

ll| apply the timer fields; taking into special consideration the 'combined* time possibilities 

sA? Throws: 

?■• Exception 

Illft getWorkerChangeOnlyFilter 

:I! protected ChangeOnlyFilter getWorkerChangeOnlyFilter ( } 

SI Return a ChangeOnlyFilter that may be assigned to the dataWorker. If none is assigned, return null 

^ ft processForm 

public boolean processForm () 

Check each of the possible fields and then save the agent return false if the form could not be processed; Note: We could also throw an 
exception to give more detail; 

ft removeEmailSupport 

protected void removeEmailSupport (IDataEventSource source) 
Remove Email Destination from the Data Event Source 

ft removeSmsSupport 

protected void removeSmsSupport ( IDataEventSource source) 
Remove SmsDestination from the DataEventSource 



